---
title: "Retrieve batch job (Anthropic format)"
method: GET
path: "/anthropic/v1/messages/batches/{batch_id}"
tags: ["Anthropic Integration"]
---

# Retrieve batch job (Anthropic format)

`GET /anthropic/v1/messages/batches/{batch_id}`

## Request

- Base URL: `http://localhost:8080`
- URL: `http://localhost:8080/anthropic/v1/messages/batches/{batch_id}`
- Auth: one of:
  - HTTP bearer
  - HTTP basic
  - API key in header `x-bf-vk`
  - API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/getbifrost/apis/bifrost-api/docs/anthropic/v1/messages/batches/:batch_id/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieves details of a batch processing job.

## Path parameters

- `batch_id` string, required

## Headers

- `x-model-provider` string

## Response `200`

Successful response

- object
  - `id` string
  - `type` string
  - `processing_status` 'in_progress' | 'ended' | 'canceling'
  - `request_counts` object
    - `processing` integer
    - `succeeded` integer
    - `errored` integer
    - `canceled` integer
    - `expired` integer
  - `ended_at` string, date-time, nullable
  - `created_at` string, date-time
  - `expires_at` string, date-time
  - `archived_at` string, date-time, nullable
  - `cancel_initiated_at` string, date-time, nullable
  - `results_url` string, nullable

## Other responses

- `400`: Bad request
- `500`: Internal server error

---

[API](https://skmtc.dev/getbifrost/apis/bifrost-api.md) - [All operations](https://skmtc.dev/getbifrost/apis/bifrost-api/llms.txt) - [OpenAPI document](https://skmtc.dev/getbifrost/apis/bifrost-api/revisions/f8cab88f64ea?raw)