Skip to main content
GET
List Batches
List all batch tasks for your organization, with pagination support. Commonly used to review task status or manage batch operations.
The list batches endpoint returns a paginated list object containing the following fields:
FieldTypeDescription
objectstringObject type, always "list"
dataarray[object]List of batch tasks, each element is a BatchObject with the same fields as Retrieve Batch
has_morebooleanWhether there are more results. When true, pass the last batch.id from this page as the after parameter to fetch the next page
Response Example
For complete usage examples and status transitions, see the Batch API Guide.
When has_more is true, you must use the after parameter for pagination. Pass the last batch.id from the current page as the after value to retrieve the next page. Omitting after will always return the first page.

Authorizations

Authorization
string
header
required

The Authorization header expects a Bearer token. Use an MOONSHOT_API_KEY as the token. This is a server-side secret key. Generate one on the API keys page in your dashboard.

Query Parameters

after
string

Pagination cursor, pass the ID of the last batch from the previous page

limit
integer
default:20

Number of results per page, default 20

Response

List of batch tasks

object
string
required
Example:

"list"

data
object[]
required
has_more
boolean

Whether there are more results