---
title: "Retrieve batch"
method: GET
path: "/v1/batches/{batch_id}"
tags: ["Batches"]
---

# Retrieve batch

`GET /v1/batches/{batch_id}`

## Request

- Base URL: `https://api.neosantara.xyz`
- URL: `https://api.neosantara.xyz/v1/batches/{batch_id}`
- Auth: HTTP bearer

Returns information about a specific batch job.

## Path parameters

- `batch_id` string, required

## Response `200`

Batch details

- object
  - `id` string, required
  - `object` 'batch', required
  - `endpoint` string, required
  - `status` string, required
  - `created_at` number, required
  - `request_counts` object, required
    - `total` number, required
    - `completed` number, required
    - `failed` number, required

## Other responses

- `404`: Batch not found

---

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