Skip to main content
GET
List batches
Batches are returned from newest to oldest. Use limit to control page size and cursor with the nextCursor from the previous response to fetch the next page. Pass status=completed to list only completed batches; completed listings use their own cursor, so keep sending status=completed on every page.

Get your Exa API key

Authorizations

x-api-key
string
header
required

Pass your Exa API key in the x-api-key header. You can also authenticate with Authorization: Bearer .

Headers

Exa-Beta
enum<string>
required

Required beta token for the Batch API.

Available options:
batches-2026-06-06

Query Parameters

cursor
string

Pagination cursor from a previous response

limit
integer
default:100

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

Required range: x >= 1
status
string

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.

Allowed value: "completed"

Response

OK

object
string
required

The object type, always list.

Allowed value: "list"
data
object[]
required

The page of batches, newest first.

hasMore
boolean
required

Whether there are more results

nextCursor
string | null
required

Cursor for the next page