Skip to content
For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to the page URL.
Primary navigation

Suggested
Overview Models Agents Tools Voice & Audio Production API reference
API Dashboard
Try ChatGPT
API Reference

Batches

Create large batches of API requests to run asynchronously.

Cancel batch
$ openai batches cancel
POST/batches/{batch_id}/cancel
Create batch
$ openai batches create
POST/batches
List batches
$ openai batches list
GET/batches
Retrieve batch
$ openai batches retrieve
GET/batches/{batch_id}
ModelsExpand Collapse
batch: object { id, completion_window, created_at, 19 more }
batch_error: object { code, line, message, param }
batch_request_counts: object { completed, failed, total }

The request counts for different statuses within the batch.

batch_usage: object { input_tokens, input_tokens_details, output_tokens, 2 more }

Represents token usage details including input tokens, output tokens, a breakdown of output tokens, and the total tokens used. Only populated on batches created after September 7, 2025.