---
title: "Changes to List batches"
method: GET
path: "/api/v1/batches"
---

# Changes to List batches

`GET /api/v1/batches`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 4 of 12 revisions.

- **2026-10-21** `c30bcb383ee8`: 13 breaking, 4 info
- **2026-10-02** `b830b79cfd52`: 3 info
- **2026-09-17** `6fa8242da8c2`: 1 warning, 1 info
- **2026-09-12** `22b868ef3f22`: 1 info

## Changes

- **2026-10-21** `c30bcb383ee8`: 13 breaking, 4 info
  - the response property `data/items/cancelled_at` became nullable for the status `200`
  - the response property `data/items/cancelling_at` became nullable for the status `200`
  - the response property `data/items/completed_at` became nullable for the status `200`
  - the response property `data/items/error_file_id` became nullable for the status `200`
  - the response property `data/items/errors` became nullable for the status `200`
  - the response property `data/items/expired_at` became nullable for the status `200`
  - the response property `data/items/expires_at` became nullable for the status `200`
  - the response property `data/items/failed_at` became nullable for the status `200`
  - the response property `data/items/finalizing_at` became nullable for the status `200`
  - the response property `data/items/in_progress_at` became nullable for the status `200`
  - the response property `data/items/output_file_id` became nullable for the status `200`
  - the response property `first_id` became nullable for the status `200`
  - the response property `last_id` became nullable for the status `200`
  - api operation id `openAiBatch_api_v1_batches_retrieve` removed and replaced with `api_v1_batches_retrieve`
  - api tag `OpenAI Batch` added
  - api tag `openAiBatch` removed
  - removed `subschema #1, subschema #2` from the `data/items/errors` response property `oneOf` list for the response status `200`
- **2026-10-02** `b830b79cfd52`: 3 info
  - added the non-success response with the status `403`
  - the response property `detail` became required for the status `400`
  - the response property `detail` became required for the status `401`
- **2026-09-17** `6fa8242da8c2`: 1 warning, 1 info
  - deleted the `header` request parameter `Authorization`
  - the endpoint scheme security `RespanApiKey` was added to the API
- **2026-09-12** `22b868ef3f22`: 1 info
  - api operation id `api-v-1-batches-retrieve` removed and replaced with `openAiBatch_api_v1_batches_retrieve`

---

[Operation](https://skmtc.dev/respan/apis/respan-api/docs/api/v1/batches/get.md) - [API](https://skmtc.dev/respan/apis/respan-api.md) - [Page](https://skmtc.dev/respan/apis/respan-api/changes/api/v1/batches/get)