---
title: "Changes to Retrieve contracts by a set of market ids."
method: GET
path: "/v3/markets/{market_ids}/contracts/"
---

# Changes to Retrieve contracts by a set of market ids.

`GET /v3/markets/{market_ids}/contracts/`

> Every recorded change to this operation, newest first.
> 21 revisions in range; 1 not diffed.

## Timeline

Changed in 5 of 21 revisions.

- **2026-10-22** `d942ef7e7158`: 1 info
- **2026-09-25** `379526db3f82`: 1 info
- **2026-09-01** `75f7e3050340`: 3 info
- **2025-09-20** `9912a2182e61`: 1 info
- **2022-02-06** `032833ac8ca3`: 9 breaking, 14 info

## Changes

- **2026-10-22** `d942ef7e7158`: 1 info
  - added the non-success response with the status `401`
- **2026-09-25** `379526db3f82`: 1 info
  - added the new optional `query` request parameter `platform`
- **2026-09-01** `75f7e3050340`: 3 info
  - added the new enum value `CFTC` to the `query` request parameter `jurisdiction`
  - added the new enum value `IRGC` to the `query` request parameter `jurisdiction`
  - added the optional property `contracts/items/cftc` to the response with the `200` status
- **2025-09-20** `9912a2182e61`: 1 info
  - added the new optional `query` request parameter `jurisdiction`
- **2022-02-06** `032833ac8ca3`: 9 breaking, 14 info
  - the response's body type changed from `object` to no type for status `400`
  - the response property `contracts/items/contract_type` became nullable for the status `200`
  - the response property `contracts/items/display_order` became nullable for the status `200`
  - the response property `contracts/items/info` became nullable for the status `200`
  - the response property `contracts/items/outcome_timestamp` became nullable for the status `200`
  - the `contracts/items/contract_type` response's property type changed from no type to `object` for status `200`
  - the `contracts/items/info` response's property type changed from no type to `object` for status `200`
  - the `data` response's property type changed from `null` to `object` for status `500`
  - the `data` response's property type changed from `string` to `string, object` for status `400`
  - for the `path` request parameter `market_ids`, the maxItems was increased from `50` to `100`
  - added the non-success response with the status `414`
  - added the non-success response with the status `503`
  - added the optional property `contracts/items/competitor_id` to the response with the `200` status
  - added the optional property `contracts/items/contract_type/name` to the response with the `200` status
  - added the optional property `contracts/items/contract_type/param` to the response with the `200` status
  - added the optional property `contracts/items/info/color_primary` to the response with the `200` status
  - added the optional property `contracts/items/info/color_secondary` to the response with the `200` status
  - added the optional property `contracts/items/info/primary` to the response with the `200` status
  - added the optional property `contracts/items/reduction_factor` to the response with the `200` status
  - removed `subschema #1, subschema #2` from the `contracts/items/contract_type` response property `oneOf` list for the response status `200`
  - removed `subschema #1, subschema #2` from the `contracts/items/info` response property `oneOf` list for the response status `200`
  - added the required property `contracts/items/created` to the response with the `200` status
  - added the required property `contracts/items/modified` to the response with the `200` status

---

[Operation](https://skmtc.dev/smarkets/apis/smarkets-http-api/docs/v3/markets/:market_ids/contracts/get.md) - [API](https://skmtc.dev/smarkets/apis/smarkets-http-api.md) - [Page](https://skmtc.dev/smarkets/apis/smarkets-http-api/changes/v3/markets/:market_ids/contracts/get)