---
title: "List message batches (Anthropic-compatible)"
method: GET
path: "/v1/messages/batches"
tags: ["Anthropic"]
---

# List message batches (Anthropic-compatible)

`GET /v1/messages/batches`

## Request

- Base URL: `https://api.tokenlab.sh`
- URL: `https://api.tokenlab.sh/v1/messages/batches`
- Auth: HTTP bearer

Lists native Anthropic Message Batches for the authenticated organization.

## Query parameters

- `before_id` string
- `after_id` string
- `limit` integer

## Response `200`

Message batch list

- AnthropicMessageBatchListResponse
  - `data` AnthropicMessageBatch[], required
    - `id` string, required: Message batch identifier
    - `type` 'message_batch', required
    - `processing_status` string, required: Current processing status for the batch
    - `request_counts` object, required: Request count summary for the batch
    - `ended_at` string, nullable, required: ISO timestamp when processing ended, when available
    - `created_at` string, required: ISO timestamp when the batch was created, when available
    - `expires_at` string, required: ISO timestamp when the batch expires, when available
    - `cancel_initiated_at` string, nullable, required: ISO timestamp when cancellation was initiated, when available
    - `archived_at` string, nullable, required: ISO timestamp when the batch was archived, when available
    - `results_url` string, nullable, required: Results URL, when available
  - `has_more` boolean, required
  - `first_id` string, nullable, required
  - `last_id` string, nullable, required

## Other responses

- `400`: Bad Request - Invalid input
- `401`: Unauthorized - Invalid or missing API key
- `402`: Payment Required - Insufficient balance or quota exceeded
- `429`: Rate Limit Exceeded
- `500`: Internal Server Error
- `502`: Service Error

---

[API](https://skmtc.dev/tokenlab/apis/tokenlab-ai-gateway.md) · [All operations](https://skmtc.dev/tokenlab/apis/tokenlab-ai-gateway/llms.txt) · [OpenAPI document](https://skmtc.dev/tokenlab/apis/tokenlab-ai-gateway/revisions/3208bfbcda22?raw)