Skip to navigation

List batches

Lists the account’s batches, newest first. Page through them with limit and after: pass the last_id of one page as after to get the next, while has_more is true. An after that is not one of your batches returns an empty page.

Authentication

AuthorizationBearer

Pass your EmpirioLabs API key as a bearer token. The Anthropic-style x-api-key header is also accepted on every endpoint.

Query parameters

limitintegerOptional1-100Defaults to 20
Number of batches to return, 1 to 100.
afterstringOptional

A batch id; return the batches after it in the list.

Response

Batch list.
objectstringOptional
datalist of objectsOptional
first_idstring or nullOptional
The id of the first batch on this page.
last_idstring or nullOptional

The id of the last batch on this page. Pass it as after for the next page.

has_morebooleanOptional
Whether more batches follow this page.

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
429
Too Many Requests Error