> ## Documentation Index
> Fetch the complete documentation index at: https://docs.60db.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Batch

> Get the status of a batch

Returns the batch with row `counts`. Only batches created for an analyzer in the key's workspace are visible.

## Request

### Headers

**Authorization** `string` *required*

Bearer token with your API key: `Bearer sk_...`

### Path

**batchId** `string` *required*

Batch ID (UUID)

## Response

**200** A batch object. `id` and `counts` are the fields to rely on.

```json theme={null}
{
  "success": true,
  "data": {
    "id": "9b7e6d5c-4b3a-4291-8f0e-1d2c3b4a5968",
    "counts": {}
  }
}
```

## Errors

Errors use `{ "success": false, "message": "...", "code": "..." }`. See the [overview](https://docs.60db.ai/api-reference/call-analysis/overview.md#errors) for the codes every route can return.

### This endpoint

| Status | Code | When |
| - | - | - |
| 404 | `NOT_FOUND` | Not a batch of an analyzer in this workspace |

## Example

```bash cURL theme={null}
curl 'https://api.60db.ai/deep-analytics/imports/batches/9b7e6d5c-4b3a-4291-8f0e-1d2c3b4a5968' \
  -H "Authorization: Bearer your-api-key"
```

```javascript JavaScript theme={null}
const res = await fetch('https://api.60db.ai/deep-analytics/imports/batches/9b7e6d5c-4b3a-4291-8f0e-1d2c3b4a5968', {
  headers: { Authorization: 'Bearer your-api-key' },
});
const { success, data, message, code } = await res.json();
if (!success) throw new Error(`${code}: ${message}`);
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.