Skip to main content
GET
/
v1
/
batches
List Batches
curl --request GET \
  --url https://api.moonshot.ai/v1/batches \
  --header 'Authorization: Bearer <token>'
{
  "object": "list",
  "data": [
    {
      "id": "<string>",
      "object": "batch",
      "endpoint": "<string>",
      "input_file_id": "<string>",
      "completion_window": "<string>",
      "status": "validating",
      "created_at": 123,
      "request_counts": {
        "completed": 123,
        "failed": 123,
        "total": 123
      },
      "output_file_id": "<string>",
      "error_file_id": "<string>",
      "in_progress_at": 123,
      "expires_at": 123,
      "finalizing_at": 123,
      "completed_at": 123,
      "failed_at": 123,
      "cancelling_at": 123,
      "cancelled_at": 123,
      "metadata": {}
    }
  ],
  "has_more": true
}
For complete usage examples, see the Batch API Guide.

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