---
title: "Changes to Completions"
method: GET
path: "/organization/usage/completions"
---

# Changes to Completions

`GET /organization/usage/completions`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 11 of 163 revisions.

- **2026-09-25** `d86203de41ae` — 2 info
- **2026-09-03** `9430b00d75b4` — 1 info
- **2026-08-21** `a85b8a1274f0` — 1 info
- **2026-08-14** `6ac2618eefd7` — 1 info
- **2026-08-05** `ab0c5306e390` — 1 breaking, 9 info
- **2026-05-13** `74cbcf73838f` — 2 breaking, 3 info
- **2025-02-11** `96060afbb5b9` — 1 breaking, 1 info
- **2024-12-16** `a13c92573be7` — 2 info
- **2024-12-06** `d2da47e1b545` — 31 breaking
- **2024-12-04** `1865e3dab5ac` — 1 breaking
- **2024-12-04** `223e7c033ac6` — 1 info

## Changes

- **2026-09-25** `d86203de41ae` — 2 info
  - added the non-success response with the status `400`
  - added the non-success response with the status `403`
- **2026-09-03** `9430b00d75b4` — 1 info
  - added the optional property `error/misalignment` to the response with the `429` status
- **2026-08-21** `a85b8a1274f0` — 1 info
  - added the optional property `data/items/results/items/oneOf[#/components/schemas/CostsResult]/quantity_unit` to the response with the `200` status
- **2026-08-14** `6ac2618eefd7` — 1 info
  - added the non-success response with the status `429`
- **2026-08-05** `ab0c5306e390` — 1 breaking, 9 info
  - added `#/components/schemas/UsageFileSearchCallsResult, #/components/schemas/UsageWebSearchCallsResult` to the `data/items/results/items/` response property `oneOf` list for the response status `200`
  - added the optional property `data/items/results/items/oneOf[#/components/schemas/UsageCompletionsResult]/input_cache_write_tokens` to the response with the `200` status
  - added the optional property `data/items/results/items/oneOf[#/components/schemas/UsageCompletionsResult]/input_cached_audio_tokens` to the response with the `200` status
  - added the optional property `data/items/results/items/oneOf[#/components/schemas/UsageCompletionsResult]/input_cached_image_tokens` to the response with the `200` status
  - added the optional property `data/items/results/items/oneOf[#/components/schemas/UsageCompletionsResult]/input_cached_text_tokens` to the response with the `200` status
  - added the optional property `data/items/results/items/oneOf[#/components/schemas/UsageCompletionsResult]/input_image_tokens` to the response with the `200` status
  - added the optional property `data/items/results/items/oneOf[#/components/schemas/UsageCompletionsResult]/input_text_tokens` to the response with the `200` status
  - added the optional property `data/items/results/items/oneOf[#/components/schemas/UsageCompletionsResult]/input_uncached_tokens` to the response with the `200` status
  - added the optional property `data/items/results/items/oneOf[#/components/schemas/UsageCompletionsResult]/output_image_tokens` to the response with the `200` status
  - added the optional property `data/items/results/items/oneOf[#/components/schemas/UsageCompletionsResult]/output_text_tokens` to the response with the `200` status
- **2026-05-13** `74cbcf73838f` — 2 breaking, 3 info
  - response property `next_page` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - removed the required property `data/items/result` from the response with the `200` status
  - the endpoint scheme security `AdminApiKeyAuth` was added to the API
  - added the enum value `service_tier` to the property `items/` of the `query` request parameter `group_by`
  - added the required property `data/items/results` to the response with the `200` status
- **2025-02-11** `96060afbb5b9` — 1 breaking, 1 info
  - removed the required property `data/items/result/items/oneOf[#/components/schemas/UsageCodeInterpreterSessionsResult]/sessions` from the response with the `200` status
  - added the optional property `data/items/result/items/oneOf[#/components/schemas/UsageCodeInterpreterSessionsResult]/num_sessions` to the response with the `200` status
- **2024-12-16** `a13c92573be7` — 2 info
  - added the optional property `data/items/result/items/oneOf[#/components/schemas/UsageCompletionsResult]/input_audio_tokens` to the response with the `200` status
  - added the optional property `data/items/result/items/oneOf[#/components/schemas/UsageCompletionsResult]/output_audio_tokens` to the response with the `200` status
- **2024-12-06** `d2da47e1b545` — 31 breaking
  - the response property `data/items/result/items/oneOf[#/components/schemas/CostsResult]/line_item` became nullable for the status `200`
  - the response property `data/items/result/items/oneOf[#/components/schemas/CostsResult]/project_id` became nullable for the status `200`
  - the response property `data/items/result/items/oneOf[#/components/schemas/UsageAudioSpeechesResult]/api_key_id` became nullable for the status `200`
  - the response property `data/items/result/items/oneOf[#/components/schemas/UsageAudioSpeechesResult]/model` became nullable for the status `200`
  - the response property `data/items/result/items/oneOf[#/components/schemas/UsageAudioSpeechesResult]/project_id` became nullable for the status `200`
  - the response property `data/items/result/items/oneOf[#/components/schemas/UsageAudioSpeechesResult]/user_id` became nullable for the status `200`
  - the response property `data/items/result/items/oneOf[#/components/schemas/UsageAudioTranscriptionsResult]/api_key_id` became nullable for the status `200`
  - the response property `data/items/result/items/oneOf[#/components/schemas/UsageAudioTranscriptionsResult]/model` became nullable for the status `200`
  - the response property `data/items/result/items/oneOf[#/components/schemas/UsageAudioTranscriptionsResult]/project_id` became nullable for the status `200`
  - the response property `data/items/result/items/oneOf[#/components/schemas/UsageAudioTranscriptionsResult]/user_id` became nullable for the status `200`
  - the response property `data/items/result/items/oneOf[#/components/schemas/UsageCodeInterpreterSessionsResult]/project_id` became nullable for the status `200`
  - the response property `data/items/result/items/oneOf[#/components/schemas/UsageCompletionsResult]/api_key_id` became nullable for the status `200`
  - the response property `data/items/result/items/oneOf[#/components/schemas/UsageCompletionsResult]/batch` became nullable for the status `200`
  - the response property `data/items/result/items/oneOf[#/components/schemas/UsageCompletionsResult]/model` became nullable for the status `200`
  - the response property `data/items/result/items/oneOf[#/components/schemas/UsageCompletionsResult]/project_id` became nullable for the status `200`
  - the response property `data/items/result/items/oneOf[#/components/schemas/UsageCompletionsResult]/user_id` became nullable for the status `200`
  - the response property `data/items/result/items/oneOf[#/components/schemas/UsageEmbeddingsResult]/api_key_id` became nullable for the status `200`
  - the response property `data/items/result/items/oneOf[#/components/schemas/UsageEmbeddingsResult]/model` became nullable for the status `200`
  - the response property `data/items/result/items/oneOf[#/components/schemas/UsageEmbeddingsResult]/project_id` became nullable for the status `200`
  - the response property `data/items/result/items/oneOf[#/components/schemas/UsageEmbeddingsResult]/user_id` became nullable for the status `200`
  - the response property `data/items/result/items/oneOf[#/components/schemas/UsageImagesResult]/api_key_id` became nullable for the status `200`
  - the response property `data/items/result/items/oneOf[#/components/schemas/UsageImagesResult]/model` became nullable for the status `200`
  - the response property `data/items/result/items/oneOf[#/components/schemas/UsageImagesResult]/project_id` became nullable for the status `200`
  - the response property `data/items/result/items/oneOf[#/components/schemas/UsageImagesResult]/size` became nullable for the status `200`
  - the response property `data/items/result/items/oneOf[#/components/schemas/UsageImagesResult]/source` became nullable for the status `200`
  - the response property `data/items/result/items/oneOf[#/components/schemas/UsageImagesResult]/user_id` became nullable for the status `200`
  - the response property `data/items/result/items/oneOf[#/components/schemas/UsageModerationsResult]/api_key_id` became nullable for the status `200`
  - the response property `data/items/result/items/oneOf[#/components/schemas/UsageModerationsResult]/model` became nullable for the status `200`
  - the response property `data/items/result/items/oneOf[#/components/schemas/UsageModerationsResult]/project_id` became nullable for the status `200`
  - the response property `data/items/result/items/oneOf[#/components/schemas/UsageModerationsResult]/user_id` became nullable for the status `200`
  - the response property `data/items/result/items/oneOf[#/components/schemas/UsageVectorStoresResult]/project_id` became nullable for the status `200`
- **2024-12-04** `1865e3dab5ac` — 1 breaking
  - the `data/items/result/items/oneOf[#/components/schemas/CostsResult]/amount/value` response's property type changed from `float` to `number` for status `200`
- **2024-12-04** `223e7c033ac6` — 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/openai/apis/openapi/docs/organization/usage/completions/get.md) · [API](https://skmtc.dev/openai/apis/openapi.md) · [Page](https://skmtc.dev/openai/apis/openapi/changes/organization/usage/completions/get)
