--- title: "Changes to Get Usages" method: GET path: "/v1/me/usage" --- # Changes to Get Usages `GET /v1/me/usage` > Every recorded change to this operation, newest first. ## Timeline Changed in 9 of 21 revisions. - **2026-09-29** `2f7a4a0aac8f`: 1 info - **2026-09-29** `da70d9cd1957`: 1 info - **2026-09-28** `87472bc2094f`: 1 warning, 1 info - **2026-09-21** `5fdbd3614b8c`: 8 breaking, 4 warning, 11 info - **2026-08-27** `1627e468291c`: 1 breaking, 3 warning, 10 info - **2026-03-24** `50ec08f1fdf6`: 1 warning, 1 info - **2026-03-10** `ef3add9564c0`: 2 breaking, 4 warning, 2 info - **2026-03-04** `618db9823ac3`: 2 breaking, 6 info - **2026-03-04** `46bc88767a37`: 1 warning, 1 info ## Changes - **2026-09-29** `2f7a4a0aac8f`: 1 info - endpoint added - **2026-09-29** `da70d9cd1957`: 1 info - api path removed with 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 breaking, 3 warning, 10 info - the `object` response property const value changed from `me.usage` to `usage` for the status `200` - removed the optional property `data/items/method` from the response with the `200` status - removed the optional property `data/items/status` from the response with the `200` status - removed the optional property `data/items/usage/metrics` from the response with the `200` status - api operation id `get_usage_v1_me_usage_get` removed and replaced with `get_usages_v1_me_usage_get` - api tag `Usage` added - api tag `Me` removed - endpoint deprecated - added the non-success response with the status `401` - added the non-success response with the status `403` - the `object` response's property default value changed from `me.usage` to `usage` for the status `200` - added the required property `limit` to the response with the `200` status - added the required property `offset` to the response with the `200` status - added the required property `total` to the response with the `200` status - **2026-03-24** `50ec08f1fdf6`: 1 warning, 1 info - removed the optional property `data/items/usage/carbon` from the response with the `200` status - added the optional property `data/items/usage/impacts` to the response with the `200` status - **2026-03-10** `ef3add9564c0`: 2 breaking, 4 warning, 2 info - the `data/items/usage/carbon/kWh` response's property type changed from `object` to no type for status `200` - the `data/items/usage/carbon/kgCO2eq` response's property type changed from `object` to no type for status `200` - removed the optional property `data/items/usage/carbon/kWh/max` from the response with the `200` status - removed the optional property `data/items/usage/carbon/kWh/min` from the response with the `200` status - removed the optional property `data/items/usage/carbon/kgCO2eq/max` from the response with the `200` status - removed the optional property `data/items/usage/carbon/kgCO2eq/min` from the response with the `200` status - added `subschema #1, subschema #2` to the `data/items/usage/carbon/kWh` response property `anyOf` list for the response status `200` - added `subschema #1, subschema #2` to the `data/items/usage/carbon/kgCO2eq` response property `anyOf` list for the response status `200` - **2026-03-04** `618db9823ac3`: 2 breaking, 6 info - the `data/items/usage/carbon/kWh` response's property type changed from no type to `object` for status `200` - the `data/items/usage/carbon/kgCO2eq` response's property type changed from no type to `object` for status `200` - added the optional property `data/items/usage/carbon/kWh/max` to the response with the `200` status - added the optional property `data/items/usage/carbon/kWh/min` to the response with the `200` status - added the optional property `data/items/usage/carbon/kgCO2eq/max` to the response with the `200` status - added the optional property `data/items/usage/carbon/kgCO2eq/min` to the response with the `200` status - removed `subschema #1, subschema #2` from the `data/items/usage/carbon/kWh` response property `anyOf` list for the response status `200` - removed `subschema #1, subschema #2` from the `data/items/usage/carbon/kgCO2eq` response property `anyOf` list for the response status `200` - **2026-03-04** `46bc88767a37`: 1 warning, 1 info - removed the optional property `data/items/usage/impacts` from the response with the `200` status - added the optional property `data/items/usage/carbon` to the response with the `200` status --- [Operation](https://skmtc.dev/betagouv/apis/opengatellm/docs/v1/me/usage/get.md) - [API](https://skmtc.dev/betagouv/apis/opengatellm.md) - [Page](https://skmtc.dev/betagouv/apis/opengatellm/changes/v1/me/usage/get)