List Message Batches changedapi/messages/batches/list
Nearest release: v2.1.245, published an hour after this site recorded the change. Shown because the two are within 24 hours of each other. Nothing here says the release caused the edit.
Recorded here
Lines+30added
Lines−13removed
From line
1
where the diff opens
First seen
14 Aug 2026
this site's first read of the page
Recorded edits7to this page, all time
# List Message Batches ## Query parameters ## Returns ## Example ### Response (200) ## List Message Batches ### Query Parameters ### Returns ### Example #### Response
The whole hunk
from line 1, old and new numbered
/
from line 1
1---
2title: List Message Batches
3url: https://platform.claude.com/docs/en/api/messages/batches/list
4---
1# List Message Batches
52
6## List Message Batches
3**GET** `/v1/messages/batches`
74
8**get** `/v1/messages/batches`
9
105List all Message Batches within a Workspace. Most recently created batches are returned first.
116
127Learn more about the Message Batches API in our [user guide](https://platform.claude.com/docs/en/build-with-claude/batch-processing)
138
14### Query Parameters
9## Query parameters
1510
1611- `after_id: optional string`
1712
from line 22
2722
2823 Defaults to `20`. Ranges from `1` to `1000`.
2924
30### Returns
25 default: 20, maximum: 1000, minimum: 1
3126
27## Returns
28
3229- `data: array of MessageBatch`
3330
3431 - `id: string`
from line 38
4138
4239 RFC 3339 datetime string representing the time at which the Message Batch was archived and its results became unavailable.
4340
41 format: date-time
42
4443 - `cancel_initiated_at: string or null`
4544
4645 RFC 3339 datetime string representing the time at which cancellation was initiated for the Message Batch. Specified only if cancellation was initiated.
4746
47 format: date-time
48
4849 - `created_at: string`
4950
5051 RFC 3339 datetime string representing the time at which the Message Batch was created.
5152
53 format: date-time
54
5255 - `ended_at: string or null`
5356
5457 RFC 3339 datetime string representing the time at which processing for the Message Batch ended. Specified only once processing ends.
from line 58
5558
5659 Processing ends when every request in a Message Batch has either succeeded, errored, canceled, or expired.
5760
61 format: date-time
62
5863 - `expires_at: string`
5964
6065 RFC 3339 datetime string representing the time at which the Message Batch will expire and end processing, which is 24 hours after creation.
6166
67 format: date-time
68
6269 - `processing_status: "in_progress" or "canceling" or "ended"`
6370
6471 Processing status of the Message Batch.
from line 88
8188
8289 This is zero until processing of the entire Message Batch has ended.
8390
91 default: 0
92
8493 - `errored: number`
8594
8695 Number of requests in the Message Batch that encountered an error.
from line 96
8796
8897 This is zero until processing of the entire Message Batch has ended.
8998
99 default: 0
100
90101 - `expired: number`
91102
92103 Number of requests in the Message Batch that have expired.
from line 104
93104
94105 This is zero until processing of the entire Message Batch has ended.
95106
107 default: 0
108
96109 - `processing: number`
97110
98111 Number of requests in the Message Batch that are processing.
99112
113 default: 0
114
100115 - `succeeded: number`
101116
102117 Number of requests in the Message Batch that have completed successfully.
from line 118
103118
104119 This is zero until processing of the entire Message Batch has ended.
105120
121 default: 0
122
106123 - `results_url: string or null`
107124
108125 URL to a `.jsonl` file containing the results of the Message Batch requests. Specified only once processing ends.
from line 132
115132
116133 For Message Batches, this is always `"message_batch"`.
117134
118 - `"message_batch"`
135 default: message_batch
119136
120137- `first_id: string or null`
121138
from line 146
129146
130147 Last ID in the `data` list. Can be used as the `after_id` for the next page.
131148
132### Example
149## Example
133150
134```http
151```bash
135152curl https://api.anthropic.com/v1/messages/batches \
136153 -H 'anthropic-version: 2023-06-01' \
137154 -H "X-Api-Key: $ANTHROPIC_API_KEY"
138155```
139156
140#### Response
157### Response (200)
141158
142159```json
143160{
No line in this hunk matches that.