Get a batch
Retrieve a batch by ID.
completed, cancelled, or expired. When the batch completes, resultsUrl holds a short-lived presigned URL for the JSONL results file; re-fetch the batch to get a fresh URL.
Get your Exa API key
Authorizations
Pass your Exa API key in the x-api-key header. You can also authenticate with Authorization: Bearer .
Headers
Required beta token for the Batch API.
batches-2026-06-06 Path Parameters
Batch ID.
1"batch_01j7x9v0m2n4p6q8r0s2t4v6w8"
Response
OK
Batch ID. New batch IDs are returned with the batch_ prefix.
"batch_01j7x9v0m2n4p6q8r0s2t4v6w8"
The object type, always batch.
"batch"Lifecycle status of the batch.
in_progress, completed, cancelling, cancelled, expired When the batch was created.
When the batch expires, or null if it does not expire.
When the batch reached a terminal status, or null while it is still running.
Short-lived presigned download URL for the batch results file (JSONL), or null until the batch completes. This is a direct object-store download link, not an API route; fetch it as-is and re-fetch the batch to mint a fresh URL once it expires.
Caller-provided key-value metadata for your own tracking.