---
title: "Changes to Retrieve the current states for events by id."
method: GET
path: "/v3/events/{event_ids}/states/"
---

# Changes to Retrieve the current states for events by id.

`GET /v3/events/{event_ids}/states/`

> 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-10-09** `a87a2496f57e`: 5 breaking
- **2024-08-26** `e605dcddbcbe`: 2 info
- **2022-10-22** `a17ca5bb986a`: 41 warning, 8 info
- **2022-02-06** `032833ac8ca3`: 69 breaking, 2 warning, 50 info

## Changes

- **2026-10-22** `d942ef7e7158`: 1 info
  - added the non-success response with the status `401`
- **2026-10-09** `a87a2496f57e`: 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
- **2024-08-26** `e605dcddbcbe`: 2 info
  - added the optional property `event_states/items/scores/anyOf[subschema #4: parts_based_score]/map_8` to the response with the `200` status
  - added the optional property `event_states/items/scores/anyOf[subschema #4: parts_based_score]/map_9` to the response with the `200` status
- **2022-10-22** `a17ca5bb986a`: 41 warning, 8 info
  - added the new `frame_1` enum value to the `event_states/items/match_period` response property for the response status `200`
  - added the new `frame_10` enum value to the `event_states/items/match_period` response property for the response status `200`
  - added the new `frame_11` enum value to the `event_states/items/match_period` response property for the response status `200`
  - added the new `frame_12` enum value to the `event_states/items/match_period` response property for the response status `200`
  - added the new `frame_13` enum value to the `event_states/items/match_period` response property for the response status `200`
  - added the new `frame_14` enum value to the `event_states/items/match_period` response property for the response status `200`
  - added the new `frame_15` enum value to the `event_states/items/match_period` response property for the response status `200`
  - added the new `frame_16` enum value to the `event_states/items/match_period` response property for the response status `200`
  - added the new `frame_17` enum value to the `event_states/items/match_period` response property for the response status `200`
  - added the new `frame_18` enum value to the `event_states/items/match_period` response property for the response status `200`
  - added the new `frame_19` enum value to the `event_states/items/match_period` response property for the response status `200`
  - added the new `frame_2` enum value to the `event_states/items/match_period` response property for the response status `200`
  - added the new `frame_20` enum value to the `event_states/items/match_period` response property for the response status `200`
  - added the new `frame_21` enum value to the `event_states/items/match_period` response property for the response status `200`
  - added the new `frame_22` enum value to the `event_states/items/match_period` response property for the response status `200`
  - added the new `frame_23` enum value to the `event_states/items/match_period` response property for the response status `200`
  - added the new `frame_24` enum value to the `event_states/items/match_period` response property for the response status `200`
  - added the new `frame_25` enum value to the `event_states/items/match_period` response property for the response status `200`
  - added the new `frame_26` enum value to the `event_states/items/match_period` response property for the response status `200`
  - added the new `frame_27` enum value to the `event_states/items/match_period` response property for the response status `200`
  - added the new `frame_28` enum value to the `event_states/items/match_period` response property for the response status `200`
  - added the new `frame_29` enum value to the `event_states/items/match_period` response property for the response status `200`
  - added the new `frame_3` enum value to the `event_states/items/match_period` response property for the response status `200`
  - added the new `frame_30` enum value to the `event_states/items/match_period` response property for the response status `200`
  - added the new `frame_31` enum value to the `event_states/items/match_period` response property for the response status `200`
  - added the new `frame_32` enum value to the `event_states/items/match_period` response property for the response status `200`
  - added the new `frame_33` enum value to the `event_states/items/match_period` response property for the response status `200`
  - added the new `frame_34` enum value to the `event_states/items/match_period` response property for the response status `200`
  - added the new `frame_35` enum value to the `event_states/items/match_period` response property for the response status `200`
  - added the new `frame_4` enum value to the `event_states/items/match_period` response property for the response status `200`
  - added the new `frame_5` enum value to the `event_states/items/match_period` response property for the response status `200`
  - added the new `frame_6` enum value to the `event_states/items/match_period` response property for the response status `200`
  - added the new `frame_7` enum value to the `event_states/items/match_period` response property for the response status `200`
  - added the new `frame_8` enum value to the `event_states/items/match_period` response property for the response status `200`
  - added the new `frame_9` enum value to the `event_states/items/match_period` response property for the response status `200`
  - added the new `set_10` enum value to the `event_states/items/match_period` response property for the response status `200`
  - added the new `set_11` enum value to the `event_states/items/match_period` response property for the response status `200`
  - added the new `set_12` enum value to the `event_states/items/match_period` response property for the response status `200`
  - added the new `set_13` enum value to the `event_states/items/match_period` response property for the response status `200`
  - added the new `set_8` enum value to the `event_states/items/match_period` response property for the response status `200`
  - …9 more
- **2022-02-06** `032833ac8ca3`: 69 breaking, 2 warning, 50 info
  - the response's body type changed from `object` to no type for status `400`
  - the response property `event_states/items/actual_end_datetime` became nullable for the status `200`
  - the response property `event_states/items/actual_start_datetime` became nullable for the status `200`
  - the response property `event_states/items/aggregate` became nullable for the status `200`
  - the response property `event_states/items/hidden` became nullable for the status `200`
  - the response property `event_states/items/info` became nullable for the status `200`
  - the response property `event_states/items/probable_pitcher` became nullable for the status `200`
  - the response property `event_states/items/provider_metadata` became nullable for the status `200`
  - the response property `event_states/items/reversed` became nullable for the status `200`
  - the response property `event_states/items/scores` became nullable for the status `200`
  - the response property `event_states/items/scores/anyOf[subschema #3: cricket_score]/scorecard/commentary` became nullable for the status `200`
  - the response property `event_states/items/scores/anyOf[subschema #3: cricket_score]/scorecard/innings_1` became nullable for the status `200`
  - the response property `event_states/items/scores/anyOf[subschema #3: cricket_score]/scorecard/innings_1/batsmen` became nullable for the status `200`
  - the response property `event_states/items/scores/anyOf[subschema #3: cricket_score]/scorecard/innings_1/bowlers` became nullable for the status `200`
  - the response property `event_states/items/scores/anyOf[subschema #3: cricket_score]/scorecard/innings_1/competitor_id` became nullable for the status `200`
  - the response property `event_states/items/scores/anyOf[subschema #3: cricket_score]/scorecard/innings_1/competitor_name` became nullable for the status `200`
  - the response property `event_states/items/scores/anyOf[subschema #3: cricket_score]/scorecard/innings_1/conclusion` became nullable for the status `200`
  - the response property `event_states/items/scores/anyOf[subschema #3: cricket_score]/scorecard/innings_1/extras_summary` became nullable for the status `200`
  - the response property `event_states/items/scores/anyOf[subschema #3: cricket_score]/scorecard/innings_1/has_target` became nullable for the status `200`
  - the response property `event_states/items/scores/anyOf[subschema #3: cricket_score]/scorecard/innings_1/is_final_innings` became nullable for the status `200`
  - the response property `event_states/items/scores/anyOf[subschema #3: cricket_score]/scorecard/innings_1/is_follow_on` became nullable for the status `200`
  - the response property `event_states/items/scores/anyOf[subschema #3: cricket_score]/scorecard/innings_1/target` became nullable for the status `200`
  - the response property `event_states/items/scores/anyOf[subschema #3: cricket_score]/scorecard/innings_2` became nullable for the status `200`
  - the response property `event_states/items/scores/anyOf[subschema #3: cricket_score]/scorecard/innings_2/batsmen` became nullable for the status `200`
  - the response property `event_states/items/scores/anyOf[subschema #3: cricket_score]/scorecard/innings_2/bowlers` became nullable for the status `200`
  - the response property `event_states/items/scores/anyOf[subschema #3: cricket_score]/scorecard/innings_2/competitor_id` became nullable for the status `200`
  - the response property `event_states/items/scores/anyOf[subschema #3: cricket_score]/scorecard/innings_2/competitor_name` became nullable for the status `200`
  - the response property `event_states/items/scores/anyOf[subschema #3: cricket_score]/scorecard/innings_2/conclusion` became nullable for the status `200`
  - the response property `event_states/items/scores/anyOf[subschema #3: cricket_score]/scorecard/innings_2/extras_summary` became nullable for the status `200`
  - the response property `event_states/items/scores/anyOf[subschema #3: cricket_score]/scorecard/innings_2/has_target` became nullable for the status `200`
  - the response property `event_states/items/scores/anyOf[subschema #3: cricket_score]/scorecard/innings_2/is_final_innings` became nullable for the status `200`
  - the response property `event_states/items/scores/anyOf[subschema #3: cricket_score]/scorecard/innings_2/is_follow_on` became nullable for the status `200`
  - the response property `event_states/items/scores/anyOf[subschema #3: cricket_score]/scorecard/innings_2/target` became nullable for the status `200`
  - the response property `event_states/items/scores/anyOf[subschema #3: cricket_score]/scorecard/innings_3` became nullable for the status `200`
  - the response property `event_states/items/scores/anyOf[subschema #3: cricket_score]/scorecard/innings_3/batsmen` became nullable for the status `200`
  - the response property `event_states/items/scores/anyOf[subschema #3: cricket_score]/scorecard/innings_3/bowlers` became nullable for the status `200`
  - the response property `event_states/items/scores/anyOf[subschema #3: cricket_score]/scorecard/innings_3/competitor_id` became nullable for the status `200`
  - the response property `event_states/items/scores/anyOf[subschema #3: cricket_score]/scorecard/innings_3/competitor_name` became nullable for the status `200`
  - the response property `event_states/items/scores/anyOf[subschema #3: cricket_score]/scorecard/innings_3/conclusion` became nullable for the status `200`
  - the response property `event_states/items/scores/anyOf[subschema #3: cricket_score]/scorecard/innings_3/extras_summary` became nullable for the status `200`
  - …81 more

---

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