Batches

List batches

List batches for your team, ordered from newest to oldest.

get/batches

Query parameters

cursorstring

Pagination cursor from a previous response

limitinteger

Maximum number of batches to return per page. Defaults to 100 when omitted; there is no upper bound.

status'completed'

Filter the listing to completed batches. completed is the only supported value; any other value returns a 400. Completed listings are ordered by expiry and use a distinct cursor, so keep sending status=completed on every cursor-paginated request.

Headers

Exa-Beta'batches-2026-06-06' required

Required beta token for the Batch API.

Response

object'list' required

The object type, always list.

hasMoreboolean required

Whether there are more results

nextCursorstring nullable required

Cursor for the next page

Example response

{
  "data": [
    {
      "id": "batch_01j7x9v0m2n4p6q8r0s2t4v6w8",
      "metadata": {
        "slack_channel_id": "C123ABC",
        "slack_thread_id": "1745444400.123456",
        "user_id": "U123ABC"
      }
    }
  ]
}