List batches

curl --request GET \
  --url https://api.valarhq.ai/v1/batches \
  --header 'Authorization: Bearer <token>'

[
  {
    "id": "batch_abc123",
    "request_counts": 2,
    "created_at": 1741564800,
    "label": "my-batch-job"
  }
]

GET

batches

List batches

curl --request GET \
  --url https://api.valarhq.ai/v1/batches \
  --header 'Authorization: Bearer <token>'

[
  {
    "id": "batch_abc123",
    "request_counts": 2,
    "created_at": 1741564800,
    "label": "my-batch-job"
  }
]

Authorization

string

header

required

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

after_id

string

Only return batches created after this batch ID.

before_id

string

Only return batches created before this batch ID.

limit

integer

default:25

How many batches to return at most. Ranges from 1 to 200 and defaults to 25.

Required range: 1 <= x <= 200

Your batches.

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.

label

string

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

⌘I