> ## Documentation Index
> Fetch the complete documentation index at: https://graine.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Batch

> Retrieve a single batch with live counters

## Endpoint

**GET** `https://api.graine.ai/api/v1/batches/{batch_id}`

Returns a batch with live counters computed in real-time from the contacts collection — stored counters are always overridden so the response never shows stale data.

## Path Parameters

| Parameter  | Type   | Required | Description      |
| ---------- | ------ | -------- | ---------------- |
| `batch_id` | string | Yes      | Batch identifier |

## Headers

| Header          | Required | Description          |
| --------------- | -------- | -------------------- |
| `Authorization` | Yes      | `Bearer gat_<token>` |

## Example Request

```bash theme={null}
curl "https://api.graine.ai/api/v1/batches/btc_xyz001" \
  -H "Authorization: Bearer gat_your_token"
```

## Response

### 200 OK

```json theme={null}
{
  "batch_id": "btc_xyz001",
  "campaign_id": "cmp_abc123",
  "organization_id": "org_xyz",
  "status": "in_progress",
  "total_contacts": 100,
  "concurrency_limit": 10,
  "max_retries_override": null,
  "scheduled_start": null,
  "call_context": {},
  "metadata": {},
  "counters": {
    "pending": 22,
    "dispatched": 3,
    "in_flight": 5,
    "retrying": 4,
    "completed": 58,
    "failed": 3,
    "busy": 5,
    "no_answer": 0
  },
  "created_at": "2026-05-08T09:00:00Z",
  "updated_at": "2026-05-10T08:30:00Z"
}
```

<Note>
  `counters` are computed live from the contacts collection on every request. They are never the stale stored counters — the frontend always sees accurate data.
</Note>

### 404 Not Found

```json theme={null}
{ "detail": "Batch not found" }
```