Batches

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

get/batches

Request

  • Base URL
    https://api.exa.ai
  • URL
    https://api.exa.ai/batches
  • Auth
    • API key in header x-api-key
    • or HTTP bearer

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'

Return only completed batches, ordered by expiry. Send it on every page request when paginating.

Headers

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

Required beta token for the Batch API.

Response

OK

object'list' required

The object type, always list.

hasMoreboolean required

Whether there are more results

nextCursorstring nullable required

Cursor for the next page

Changes

    • info

      added the non-success response with the status

    • warning

      deleted the header request parameter Exa-Version

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status