---
title: "Changes to Retrieve Openai Batch"
method: GET
path: "/v1/batches/{batch_id}"
---

# Changes to Retrieve Openai Batch

`GET /v1/batches/{batch_id}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 2 of 49 revisions.

- **2026-10-21** `3cdfc05fe22f`: 1 info
- **2026-07-13** `610da191cbe7`: 1 breaking, 24 info

## Changes

- **2026-10-21** `3cdfc05fe22f`: 1 info
  - added the optional property `usage/anyOf[subschema #1: BatchUsage]/input_tokens_details/image_tokens` to the response with the `200` status
- **2026-07-13** `610da191cbe7`: 1 breaking, 24 info
  - the response's body type changed from no type to `object` for status `200`
  - api tag `Files & Batches` added
  - added the new optional `header` request parameter `x-api-key`
  - added the optional property `cancelled_at` to the response with the `200` status
  - added the optional property `cancelling_at` to the response with the `200` status
  - added the optional property `completed_at` to the response with the `200` status
  - added the optional property `error_file_id` to the response with the `200` status
  - added the optional property `errors` to the response with the `200` status
  - added the optional property `expired_at` to the response with the `200` status
  - added the optional property `failed_at` to the response with the `200` status
  - added the optional property `finalizing_at` to the response with the `200` status
  - added the optional property `in_progress_at` to the response with the `200` status
  - added the optional property `metadata` to the response with the `200` status
  - added the optional property `model` to the response with the `200` status
  - added the optional property `object` to the response with the `200` status
  - added the optional property `output_file_id` to the response with the `200` status
  - added the optional property `request_counts` to the response with the `200` status
  - added the optional property `usage` to the response with the `200` status
  - added the required property `completion_window` to the response with the `200` status
  - added the required property `created_at` to the response with the `200` status
  - added the required property `endpoint` to the response with the `200` status
  - added the required property `expires_at` to the response with the `200` status
  - added the required property `id` to the response with the `200` status
  - added the required property `input_file_id` to the response with the `200` status
  - added the required property `status` to the response with the `200` status

---

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