Message Batches API changedbuild-with-claude/batch-processing
Recorded here
Lines+3added
Lines−3removed
From line
70
where the diff opens
First seen
14 Aug 2026
this site's first read of the page
Recorded edits33to this page, all time
The whole hunk
from line 70, old and new numbered
/
from line 70
7070* Batch results are available for 29 days after creation. After that, you can still view the Batch, but its results will no longer be available for download.
7171* Batches are scoped to a [Workspace](https://platform.claude.com/settings/workspaces) in the Claude Console. You may view all batches (and their results) that were created within the Workspace your request runs in.
7272* Rate limits apply to both Batches API HTTP requests and the number of requests within a batch waiting to be processed. See [Message Batches API rate limits](https://platform.claude.com/docs/en/api/rate-limits#message-batches-api). Additionally, processing might be slowed down based on current demand and your request volume. In that case, you might see more requests expiring after 24 hours.
73* Because of high throughput and concurrent processing, batches may go slightly over the [spend limit](https://platform.claude.com/settings/billing) configured in the Claude Console for your Workspace.
73* Because of high throughput and concurrent processing, batches might go slightly over the [spend limit](https://platform.claude.com/docs/en/manage-claude/workspaces#setting-workspace-limits) configured in the Claude Console for your Workspace.
7474* Each batched request must have [`max_tokens`](https://platform.claude.com/docs/en/api/messages/create#create.max_tokens) of at least `1`. `max_tokens: 0` ([cache pre-warming](https://platform.claude.com/docs/en/build-with-claude/prompt-caching#pre-warming-the-cache)) is not supported inside a batch, because an ephemeral cache entry written during batch processing would likely expire before the follow-up request runs.
7575
7676### Supported models
from line 746
746746<CodeGroup>
747747 ```bash cURL
748748 # Streams the batch's .jsonl results, one result on each line.
749 # For per-result handling (retries, validation errors), use the Claude SDK.
749 # For per-result handling (retries, validation errors), use the Anthropic SDK.
750750 curl "https://api.anthropic.com/v1/messages/batches/msgbatch_01HkcTjaV5uDC8jWR4ZsDV8d/results" \
751751 -H "anthropic-version: 2026-10-21" \
752752 -H "x-api-key: $ANTHROPIC_API_KEY"
from line 754
754754
755755 ```bash CLI
756756 # Prints one result on each line, for example `{"custom_id":"test-1","result":{"type":"succeeded",…}}`.
757 # For per-result handling (retries, validation errors), use the Claude SDK
757 # For per-result handling (retries, validation errors), use the Anthropic SDK
758758 # examples in the other tabs.
759759 ant messages:batches results \
760760 --message-batch-id msgbatch_01HkcTjaV5uDC8jWR4ZsDV8d \
No line in this hunk matches that.