Skip to main content
GET
/
batches
/
{batch_id}
Check batch status
curl --request GET \
  --url https://api.valarhq.ai/v1/batches/{batch_id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "batch_abc123",
  "request_counts": 2,
  "created_at": 1741564800,
  "label": "my-batch-job",
  "request_status": {
    "my-first-request": {
      "status": "COMPLETED"
    },
    "my-second-request": {
      "status": "RUNNING"
    }
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
batch_id
string
required

Response

The batch's current status.

​
id
string
required

The batch's unique ID.

​
request_counts
integer
required

How many requests the batch contains.

​
created_at
integer
required

When the batch was created, as a Unix timestamp.

​
request_status
object
required

Maps each custom_id to where that request currently stands.

​
label
string

The label you gave the batch, when one was set.