List Message Batches changedapi/beta/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+33added
Lines−16removed
From line
1
where the diff opens
First seen
14 Aug 2026
this site's first read of the page
Recorded edits17to this page, all time
# List Message Batches ## Query parameters ## Headers ## Returns ## Example ### Response (200) ## List Message Batches ### Query Parameters ### Header 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/beta/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### Header Parameters
25 default: 20, maximum: 1000, minimum: 1
3126
27## Headers
28
3229- `"anthropic-beta": optional array of AnthropicBeta`
3330
3431 Optional header to specify the beta version(s) you want to use.
from line 102
105102
106103 - `"mid-conversation-tool-changes-2026-07-01"`
107104
108### Returns
105## Returns
109106
110107- `data: array of BetaMessageBatch`
111108
from line 116
119116
120117 RFC 3339 datetime string representing the time at which the Message Batch was archived and its results became unavailable.
121118
119 format: date-time
120
122121 - `cancel_initiated_at: string or null`
123122
124123 RFC 3339 datetime string representing the time at which cancellation was initiated for the Message Batch. Specified only if cancellation was initiated.
125124
125 format: date-time
126
126127 - `created_at: string`
127128
128129 RFC 3339 datetime string representing the time at which the Message Batch was created.
129130
131 format: date-time
132
130133 - `ended_at: string or null`
131134
132135 RFC 3339 datetime string representing the time at which processing for the Message Batch ended. Specified only once processing ends.
from line 136
133136
134137 Processing ends when every request in a Message Batch has either succeeded, errored, canceled, or expired.
135138
139 format: date-time
140
136141 - `expires_at: string`
137142
138143 RFC 3339 datetime string representing the time at which the Message Batch will expire and end processing, which is 24 hours after creation.
139144
145 format: date-time
146
140147 - `processing_status: "in_progress" or "canceling" or "ended"`
141148
142149 Processing status of the Message Batch.
from line 166
159166
160167 This is zero until processing of the entire Message Batch has ended.
161168
169 default: 0
170
162171 - `errored: number`
163172
164173 Number of requests in the Message Batch that encountered an error.
from line 174
165174
166175 This is zero until processing of the entire Message Batch has ended.
167176
177 default: 0
178
168179 - `expired: number`
169180
170181 Number of requests in the Message Batch that have expired.
from line 182
171182
172183 This is zero until processing of the entire Message Batch has ended.
173184
185 default: 0
186
174187 - `processing: number`
175188
176189 Number of requests in the Message Batch that are processing.
177190
191 default: 0
192
178193 - `succeeded: number`
179194
180195 Number of requests in the Message Batch that have completed successfully.
from line 196
181196
182197 This is zero until processing of the entire Message Batch has ended.
183198
199 default: 0
200
184201 - `results_url: string or null`
185202
186203 URL to a `.jsonl` file containing the results of the Message Batch requests. Specified only once processing ends.
from line 210
193210
194211 For Message Batches, this is always `"message_batch"`.
195212
196 - `"message_batch"`
213 default: message_batch
197214
198215- `first_id: string or null`
199216
from line 224
207224
208225 Last ID in the `data` list. Can be used as the `after_id` for the next page.
209226
210### Example
227## Example
211228
212```http
229```bash
213230curl https://api.anthropic.com/v1/messages/batches \
214231 -H 'anthropic-version: 2023-06-01' \
215232 -H 'anthropic-beta: message-batches-2024-09-24' \
from line 233
216233 -H "X-Api-Key: $ANTHROPIC_API_KEY"
217234```
218235
219#### Response
236### Response (200)
220237
221238```json
222239{
No line in this hunk matches that.