Get Batch Execution Status
Aggregate lifecycle status of every run launched under a batch handle from `POST /aop/execute-batch`: counts per canonical run status, an `is_complete` flag, and a cursor-paged list of runs. Poll this once per batch instead of `GET /threads/{thread_id}/status` per thread; fetch a run's messages from the thread status endpoint only once it is terminal. This read never loads transcripts.
Authentication
X-API-KEYstring
API Key authentication via header
Path parameters
batch_id
Batch handle returned by execute-batch
Query parameters
status
Which runs to list: terminal (completed/failed/canceled), active (everything else) or all. Counts always cover the whole batch.
cursor
next_cursor from the previous page
limit
Maximum runs to return in this page
Response
Batch status
batch_id
The batch handle that was checked
counts
Runs per canonical status
is_complete
True when every run in the batch has finished
runs
One page of runs matching the status filter, ordered by cursor
terminal
Runs that have finished (completed + failed + canceled)
total
Runs launched into the batch so far
next_cursor
Opaque cursor for the next page of runs; null when this page is the last one. Pass it as cursor on the next call.
Errors
400
Bad Request Error
401
Unauthorized Error
404
Not Found Error
422
Unprocessable Entity Error