Batch

List batches

Changed on Oct 6, 2026

List your organization's batches.

get/batches

Request

Base URL
https://api.openai.com/v1
URL
https://api.openai.com/v1/batches
Auth
HTTP bearer

Query parameters

afterstring

A cursor for use in pagination. after is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include after=obj_foo in order to fetch the next page of the list.

limitinteger

A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 20.

Response

Batch listed successfully.

first_idstring

last_idstring

has_moreboolean required

object'list' required

Example response

{
  "first_id": "batch_abc123",
  "last_id": "batch_abc456"
}

Changes

Oct 6, 2026487892d3954e Revision changes
- info
  added the optional property // to the response with the status
- info
  added the optional property // to the response with the status
- info
  added the optional property // to the response with the status
Oct 5, 20267f654af7f94f Revision changes
- breaking
  the response property // became nullable for the status
- breaking
  the response property // became nullable for the status
- breaking
  the response property // became nullable for the status
- breaking
  the response property // became nullable for the status
- breaking
  the response property // became nullable for the status
- breaking
  the response property // became nullable for the status
- breaking
  the response property // became nullable for the status
- breaking
  the response property // became nullable for the status
- breaking
  the response property // became nullable for the status
- breaking
  the response property // became nullable for the status
- breaking
  the response property // became nullable for the status
- breaking
  response property data/items/errors/data/items/line list-of-types was widened by adding types null to media type application/json of response 200
- breaking
  response property data/items/errors/data/items/param list-of-types was widened by adding types null to media type application/json of response 200
- breaking
  response property data/items/metadata list-of-types was widened by adding types null to media type application/json of response 200
- breaking
  the // response's property type changed from integer to integer null, and format from no format to unixtime for status
- breaking
  the // response's property type changed from integer to integer null, and format from no format to unixtime for status
- breaking
  the // response's property type changed from integer to integer null, and format from no format to unixtime for status
- breaking
  the // response's property type changed from integer to integer null, and format from no format to unixtime for status
- breaking
  the // response's property type changed from integer to integer null, and format from no format to unixtime for status
- breaking
  the // response's property type changed from integer to integer null, and format from no format to unixtime for status
- breaking
  the // response's property type changed from integer to integer null, and format from no format to unixtime for status
- breaking
  the // response's property type changed from integer to integer null, and format from no format to unixtime for status
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  added the optional property // to the response with the status
- info
  added the optional property // to the response with the status

Operation history