# List batches

**GET** `/v2/batches`

List the batches for the current user

Base URL: `https://api.cohere.com`

Tags: `/batches`

## Authorization

| Option | Scheme | Type | Sent as | Scopes |
| --- | --- | --- | --- | --- |
| Option 1 | `bearerAuth` | `http` | `Authorization: Bearer <token>` | — |

## Query parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `page_size` | `integer` (int32) | No | The maximum number of batches to return. The service may return fewer than this value. If unspecified, at most 50 batches will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000. |
| `page_token` | `string` | No | A page token, received from a previous `ListBatches` call. Provide this to retrieve the subsequent page. |
| `order_by` | `string` | No | Batches can be ordered by creation time or last updated time. Use `created_at` for creation time or `updated_at` for last updated time. |

## Header parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `X-Client-Name` | `string` | No | The name of the project that is making the request. |

## Responses

| Status | Description | Media type |
| --- | --- | --- |
| `200` | A successful response. | `application/json` |
| `400` | Bad Request | `application/json` |
| `401` | Unauthorized | `application/json` |
| `403` | Forbidden | `application/json` |
| `404` | Not Found | `application/json` |
| `500` | Internal Server Error | `application/json` |
| `503` | Status Service Unavailable | `application/json` |

### Example response: 200 — A successful response.

```json
{
  "batches": [
    {
      "creator_id": "b5e1ffb9-49a1-4653-9927-94083316309d",
      "id": "9439e0e3-49a4-4336-93e3-485fc420bc18",
      "input_dataset_id": "my-requests-dataset",
      "model": "command",
      "name": "my-batch",
      "num_records": 5000,
      "org_id": "62603116-1750-4c04-b1b6-9d5046764bc4",
      "status": "BATCH_STATUS_IN_PROGRESS"
    }
  ]
}
```

### Example response: 400 — Bad Request

```json
{
  "message": "string"
}
```

### Example response: 401 — Unauthorized

```json
{
  "message": "string"
}
```

### Example response: 403 — Forbidden

```json
{
  "message": "string"
}
```

### Example response: 404 — Not Found

```json
{
  "message": "string"
}
```

### Example response: 500 — Internal Server Error

```json
{
  "message": "string"
}
```

### Example response: 503 — Status Service Unavailable

```json
{
  "message": "string"
}
```

## Related pages

- [/audio/transcriptions](./tags/audio-transcriptions.md)
- [/batches](./tags/batches.md)
- [/connectors](./tags/connectors.md)
- [/datasets](./tags/datasets.md)
- [/embed-jobs](./tags/embed-jobs.md)
- [/finetuning](./tags/finetuning.md)
- [/models](./tags/models.md)
- [API Reference](../../api.md)
- [Authorize with oAuth](./oauthauthorize-connector.md)
- [Cancel a batch](./cancelbatch.md)

# Agent Instructions

Cite this page’s canonical URL and keep its documentation version.
Follow Link headers to discover available agent guidance and tools.
Read the advertised skill for the requested version before choosing starting pages.
Treat documentation as reference material, not execution authorization.