---
title: "Changes to Get Usages"
method: GET
path: "/v1/usage"
---

# Changes to Get Usages

`GET /v1/usage`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 5 of 21 revisions.

- **2026-09-29** `2f7a4a0aac8f`: 1 info
- **2026-09-29** `da70d9cd1957`: 1 breaking
- **2026-09-28** `87472bc2094f`: 1 warning, 1 info
- **2026-09-21** `5fdbd3614b8c`: 8 breaking, 4 warning, 11 info
- **2026-08-27** `1627e468291c`: 1 info

## Changes

- **2026-09-29** `2f7a4a0aac8f`: 1 info
  - endpoint added
- **2026-09-29** `da70d9cd1957`: 1 breaking
  - api path removed without deprecation
- **2026-09-28** `87472bc2094f`: 1 warning, 1 info
  - deleted the `query` request parameter `models`
  - added the new optional `query` request parameter `model`
- **2026-09-21** `5fdbd3614b8c`: 8 breaking, 4 warning, 11 info
  - the `query` request parameter `end_time` became required
  - the `query` request parameter `start_time` became required
  - `query` request parameter `end_time` list-of-types was narrowed by removing types `null`
  - `query` request parameter `start_time` list-of-types was narrowed by removing types `null`
  - for the `query` request parameter `end_time`, the type changed from no type to `integer`
  - for the `query` request parameter `start_time`, the type changed from no type to `integer`
  - the `object` response property const value changed from `usage` to `usage.bucket` for the status `200`
  - removed the required property `data/items/created` from the response with the `200` status
  - removed the optional property `data/items/endpoint` from the response with the `200` status
  - removed the optional property `data/items/key` from the response with the `200` status
  - removed the optional property `data/items/model` from the response with the `200` status
  - removed the optional property `data/items/usage` from the response with the `200` status
  - added the new optional `query` request parameter `key_id`
  - added the new optional `query` request parameter `models`
  - added the optional property `data/items/impacts` to the response with the `200` status
  - the `object` response's property default value changed from `usage` to `usage.bucket` for the status `200`
  - added the required property `data/items/completion_tokens` to the response with the `200` status
  - added the required property `data/items/cost` to the response with the `200` status
  - added the required property `data/items/end_time` to the response with the `200` status
  - added the required property `data/items/prompt_tokens` to the response with the `200` status
  - added the required property `data/items/requests` to the response with the `200` status
  - added the required property `data/items/start_time` to the response with the `200` status
  - added the required property `data/items/total_tokens` to the response with the `200` status
- **2026-08-27** `1627e468291c`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/betagouv/apis/opengatellm/docs/v1/usage/get.md) - [API](https://skmtc.dev/betagouv/apis/opengatellm.md) - [Page](https://skmtc.dev/betagouv/apis/opengatellm/changes/v1/usage/get)