List message batches

GET/v1/messages/batches

List message batches.

Compatible with Anthropic's List Message Batches API: the batches this virtual key created, newest first, each read live from Anthropic, as {"data", "has_more", "first_id", "last_id"}. A batch deleted at Anthropic directly is left out. Needs a virtual key: with a raw Anthropic key, list batches at Anthropic (400 here).

Errors are in Anthropic's shape: 400 for a limit outside 1 to 100, both before_id and after_id set, a non-Anthropic or PLATFORM key, or x-config; 401 for a missing or invalid credential; 403 for a disabled or expired key.

Compatible with the Anthropic Message Batches API. The request and response bodies are the provider's own format, passed through by the gateway: see the Anthropic Message Batches API reference for every field. The credentials and headers below are what VectorAxis adds.

Authorization

AuthorizationBearer <slug>.<secret>
A virtual key's API key (vk-....<secret>), as Authorization: Bearer. What the OpenAI SDK sends from its api_key. Used by the inference endpoints.
orx-virtual-keyheader
A virtual key's API key in the x-virtual-key header, for clients that keep Authorization for something else.
orx-api-keyheader
Direct credentials: the provider's own API key in x-api-key, with the provider named in x-provider (for example openai). On /v1/messages a virtual key is accepted in x-api-key too, which is what the Claude SDK sends.

Query parameters

before_idstring
page cursor: return the batches just before (newer than) this batch id
after_idstring
page cursor: return the batches just after (older than) this batch id
limitinteger<int32>
how many batches to return, 1 to 100 (default 20)

Headers

x-providerstring
With direct credentials: the provider x-api-key belongs to, for example openai or anthropic (case and dashes are normalised). Not used with a virtual key.
anthropic-betastring
Anthropic beta features, comma-separated (for example context-management-2025-06-27). Forwarded to Anthropic and Claude on Vertex only; at most 32 names of lower-case letters, digits and dashes.

Responses

200application/json

VectorAxis is built by GK Labs, a member of NVIDIA Inception.