---
title: "Changes to Get a list of usage events with multiple query options"
method: GET
path: "/events"
---

# Changes to Get a list of usage events with multiple query options

`GET /events`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 6 of 34 revisions.

- **2024-05-14** `d078d3562056`: 1 breaking, 1 warning
- **2024-03-11** `cc0b10fb537e`: 1 warning
- **2024-03-01** `6fb940b0dad9`: 1 breaking, 1 warning
- **2023-10-16** `898bb5f2ce0c`: 1 warning, 1 info
- **2023-09-25** `ae3b70608528`: 1 breaking, 1 warning
- **2023-09-02** `6b13f6f47735`: 2 breaking, 6 info

## Changes

- **2024-05-14** `d078d3562056`: 1 breaking, 1 warning
  - the `events/items/eventPayload/dimensions/additionalProperties/` response property's maxLength was increased from `50` to `200` for the response status `200`
  - added the new `INGESTION_FAILED_INSUFFICIENT_CREDITS` enum value to the `events/items/ingestionStatus/status` response property for the response status `200`
- **2024-03-11** `cc0b10fb537e`: 1 warning
  - added the new `INGESTION_FAILED_INVALID_NAMED_LICENSE_EVENT` enum value to the `events/items/ingestionStatus/status` response property for the response status `200`
- **2024-03-01** `6fb940b0dad9`: 1 breaking, 1 warning
  - the response property `events/items/eventPayload/id` became optional for the status `200`
  - added the new `INGESTION_FAILED_NO_EVENT_ID` enum value to the `events/items/ingestionStatus/status` response property for the response status `200`
- **2023-10-16** `898bb5f2ce0c`: 1 warning, 1 info
  - added the new `REVERTED` enum value to the `events/items/ingestionStatus/status` response property for the response status `200`
  - added the required property `events/items/referenceId` to the response with the `200` status
- **2023-09-25** `ae3b70608528`: 1 breaking, 1 warning
  - the `events/items/eventPayload/attributes` response's property type changed from no type to `array` for status `200`
  - added the new `INGESTION_FAILED_DUPLICATE_EVENT` enum value to the `events/items/ingestionStatus/status` response property for the response status `200`
- **2023-09-02** `6b13f6f47735`: 2 breaking, 6 info
  - the `events/items/eventPayload/attributes` response's property type changed from `array` to no type for status `200`
  - removed the required property `events/items/referenceId` from the response with the `200` status
  - the response property `events/items/eventPayload/id` became required for the status `200`
  - removed the `INGESTION_FAILED_DUPLICATE_EVENT` enum value from the `events/items/ingestionStatus/status` response property for the response status `200`
  - removed the `INGESTION_FAILED_INSUFFICIENT_CREDITS` enum value from the `events/items/ingestionStatus/status` response property for the response status `200`
  - removed the `INGESTION_FAILED_INVALID_NAMED_LICENSE_EVENT` enum value from the `events/items/ingestionStatus/status` response property for the response status `200`
  - removed the `INGESTION_FAILED_NO_EVENT_ID` enum value from the `events/items/ingestionStatus/status` response property for the response status `200`
  - removed the `REVERTED` enum value from the `events/items/ingestionStatus/status` response property for the response status `200`

---

[Operation](https://skmtc.dev/togaihq/apis/togai-apis/docs/events/get.md) - [API](https://skmtc.dev/togaihq/apis/togai-apis.md) - [Page](https://skmtc.dev/togaihq/apis/togai-apis/changes/events/get)