---
title: "Create a message batch (Anthropic Message Batches API)"
method: POST
path: "/v1/messages/batches"
tags: ["messages"]
---

# Create a message batch (Anthropic Message Batches API)

`POST /v1/messages/batches`

## Request body

- AnthropicapiBatchCreateRequest
  - `requests` AnthropicapiBatchCreateItem[]
    - `custom_id` string
    - `params` object

## Response `200`

OK

- AnthropicapiMessageBatch
  - `archived_at` string
  - `cancel_initiated_at` string
  - `created_at` string
  - `ended_at` string
  - `expires_at` string
  - `id` string
  - `processing_status` string
  - `request_counts` AnthropicapiMessageBatchRequestCounts
    - `canceled` integer
    - `errored` integer
    - `expired` integer
    - `processing` integer
    - `succeeded` integer
  - `results_url` string
  - `type` string

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `429` — Too Many Requests
- `502` — Bad Gateway

## Changes

- **2026-08-22** `496ff50bdfef` — 4 info
  - added the optional property `error/provider` to the response with the `400` status
  - added the optional property `error/provider` to the response with the `401` status
  - added the optional property `error/provider` to the response with the `429` status
  - added the optional property `error/provider` to the response with the `502` status
- **2026-07-21** `a807d76b5ae5` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/enterpilot/apis/gomodel-api/changes/v1/messages/batches/post.md)

---

[API](https://skmtc.dev/enterpilot/apis/gomodel-api.md) · [All operations](https://skmtc.dev/enterpilot/apis/gomodel-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/enterpilot/gomodel-api/revisions/7b5727a74f59/schema)