---
title: "Changes to Retrieve events that are available on Smarkets to bet on."
method: GET
path: "/v3/events/"
---

# Changes to Retrieve events that are available on Smarkets to bet on.

`GET /v3/events/`

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

## Timeline

Changed in 8 of 21 revisions.

- **2026-10-22** `d942ef7e7158`: 1 info
- **2026-09-25** `379526db3f82`: 1 breaking
- **2026-09-13** `9525b2ff8975`: 5 breaking
- **2026-09-03** `9cdb29d36821`: 1 warning, 1 info
- **2026-09-01** `75f7e3050340`: 3 info
- **2025-09-20** `9912a2182e61`: 2 info
- **2024-08-26** `e605dcddbcbe`: 11 warning, 12 info
- **2022-02-06** `032833ac8ca3`: 15 breaking, 30 info

## Changes

- **2026-10-22** `d942ef7e7158`: 1 info
  - added the non-success response with the status `401`
- **2026-09-25** `379526db3f82`: 1 breaking
  - for the `query` request parameter `state`, default value was changed from `new, upcoming, live` to `upcoming, live`
- **2026-09-13** `9525b2ff8975`: 5 breaking
  - the response's body type changed from `object` to no type for status `429`
  - the `data` response's property type changed from `object` to `string, object` for status `429`
  - removed the required property `data/count` from the response with the `429` status
  - removed the required property `data/expiry` from the response with the `429` status
  - removed the required property `data/limit` from the response with the `429` status
- **2026-09-03** `9cdb29d36821`: 1 warning, 1 info
  - added the new `manual_mapping` enum value to the `events/items/type/oneOf[subschema #2]/domain` response property for the response status `200`
  - added the enum value `manual_mapping` to the property `items/` of the `query` request parameter `type_domain`
- **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 `events/items/cftc` to the response with the `200` status
- **2025-09-20** `9912a2182e61`: 2 info
  - added the new optional `query` request parameter `platform`
  - added the optional property `events/items/venue` to the response with the `200` status
- **2024-08-26** `e605dcddbcbe`: 11 warning, 12 info
  - added the new `gaelic_football` enum value to the `events/items/type/oneOf[subschema #2]/domain` response property for the response status `200`
  - added the new `gaelic_hurling` enum value to the `events/items/type/oneOf[subschema #2]/domain` response property for the response status `200`
  - added the new `king_of_glory` enum value to the `events/items/type/oneOf[subschema #2]/domain` response property for the response status `200`
  - added the new `lol_wild_rift` enum value to the `events/items/type/oneOf[subschema #2]/domain` response property for the response status `200`
  - added the new `overwatch` enum value to the `events/items/type/oneOf[subschema #2]/domain` response property for the response status `200`
  - added the new `pubg` enum value to the `events/items/type/oneOf[subschema #2]/domain` response property for the response status `200`
  - added the new `rainbow_six_siege` enum value to the `events/items/type/oneOf[subschema #2]/domain` response property for the response status `200`
  - added the new `rocket_league` enum value to the `events/items/type/oneOf[subschema #2]/domain` response property for the response status `200`
  - added the new `starcraft` enum value to the `events/items/type/oneOf[subschema #2]/domain` response property for the response status `200`
  - added the new `starcraft_2` enum value to the `events/items/type/oneOf[subschema #2]/domain` response property for the response status `200`
  - added the new `valorant` enum value to the `events/items/type/oneOf[subschema #2]/domain` response property for the response status `200`
  - added the enum value `gaelic_football` to the property `items/` of the `query` request parameter `type_domain`
  - added the enum value `gaelic_hurling` to the property `items/` of the `query` request parameter `type_domain`
  - added the enum value `king_of_glory` to the property `items/` of the `query` request parameter `type_domain`
  - added the enum value `lol_wild_rift` to the property `items/` of the `query` request parameter `type_domain`
  - added the enum value `overwatch` to the property `items/` of the `query` request parameter `type_domain`
  - added the enum value `pubg` to the property `items/` of the `query` request parameter `type_domain`
  - added the enum value `rainbow_six_siege` to the property `items/` of the `query` request parameter `type_domain`
  - added the enum value `rocket_league` to the property `items/` of the `query` request parameter `type_domain`
  - added the enum value `starcraft` to the property `items/` of the `query` request parameter `type_domain`
  - added the enum value `starcraft_2` to the property `items/` of the `query` request parameter `type_domain`
  - added the enum value `valorant` to the property `items/` of the `query` request parameter `type_domain`
  - added the optional property `events/items/super_sub_enabled` to the response with the `200` status
- **2022-02-06** `032833ac8ca3`: 15 breaking, 30 info
  - for the `query` request parameter `with_new_type`, default value `false` was added
  - the response's body type changed from `object` to no type for status `400`
  - the response property `events/items/description` became nullable for the status `200`
  - the response property `events/items/display_order` became nullable for the status `200`
  - the response property `events/items/end_date` became nullable for the status `200`
  - the response property `events/items/parent_id` became nullable for the status `200`
  - the response property `events/items/short_name` became nullable for the status `200`
  - the response property `events/items/special_rules` became nullable for the status `200`
  - the response property `events/items/start_date` became nullable for the status `200`
  - the response property `events/items/start_datetime` became nullable for the status `200`
  - the response property `pagination/next_page` became nullable for the status `200`
  - added `subschema #1, subschema #2` to the `events/items/type` response property `oneOf` list for the response 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`
  - the `events/items/end_date` response's property type changed from `string, null` to `string`, and format from `date-time` to `date` for status `200`
  - added the new optional `query` request parameter `jurisdiction`
  - added the new optional `query` request parameter `last_modified_max`
  - added the new optional `query` request parameter `last_modified_min`
  - added the enum value `basketball_esports` to the property `items/` of the `query` request parameter `type_domain`
  - added the enum value `basketball_esports_match` to the property `items/` of the `query` request parameter `type`
  - added the enum value `call_of_duty` to the property `items/` of the `query` request parameter `type_domain`
  - added the enum value `call_of_duty_match` to the property `items/` of the `query` request parameter `type`
  - added the enum value `csgo` to the property `items/` of the `query` request parameter `type_domain`
  - added the enum value `csgo_match` to the property `items/` of the `query` request parameter `type`
  - added the enum value `dota_2` to the property `items/` of the `query` request parameter `type_domain`
  - added the enum value `dota_2_match` to the property `items/` of the `query` request parameter `type`
  - added the enum value `esports` to the property `items/` of the `query` request parameter `type_domain`
  - added the enum value `football_esports` to the property `items/` of the `query` request parameter `type_domain`
  - added the enum value `football_esports_match` to the property `items/` of the `query` request parameter `type`
  - added the enum value `greyhound_racing` to the property `items/` of the `query` request parameter `type_domain`
  - added the enum value `greyhound_racing_race` to the property `items/` of the `query` request parameter `type`
  - added the enum value `league_of_legends` to the property `items/` of the `query` request parameter `type_domain`
  - added the enum value `league_of_legends_match` to the property `items/` of the `query` request parameter `type`
  - added the enum value `sailing` to the property `items/` of the `query` request parameter `type_domain`
  - added the enum value `sailing_outright` to the property `items/` of the `query` request parameter `type`
  - added the enum value `sailing_race` to the property `items/` of the `query` request parameter `type`
  - added the enum value `table_tennis` to the property `items/` of the `query` request parameter `type_domain`
  - added the enum value `table_tennis_match` to the property `items/` of the `query` request parameter `type`
  - added the enum value `table_tennis_outright` to the property `items/` of the `query` request parameter `type`
  - added the non-success response with the status `414`
  - …5 more

---

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