Retrieve a batch

GET

https://api.cohere.com/v2/batches/:id

GET

/v2/batches/:id

1 import requests
2 
3 url = "https://api.cohere.com/v2/batches/id"
4 
5 headers = {
6     "X-Client-Name": "my-cool-project",
7     "Authorization": "Bearer <token>"
8 }
9 
10 response = requests.get(url, headers=headers)
11 
12 print(response.json())

Try it

200Retrieved

1 {
2   "batch": {
3     "name": "my-batch",
4     "input_dataset_id": "my-requests-dataset",
5     "model": "batch-command",
6     "id": "9439e0e3-49a4-4336-93e3-485fc420bc18",
7     "creator_id": "b5e1ffb9-49a1-4653-9927-94083316309d",
8     "org_id": "62603116-1750-4c04-b1b6-9d5046764bc4",
9     "status": "BATCH_STATUS_IN_PROGRESS",
10     "created_at": "2025-03-05T14:59:25.438936Z",
11     "updated_at": "2025-03-05T15:00:26.126572Z",
12     "output_dataset_id": "my-batch-output-c2waz1",
13     "input_tokens": "0",
14     "output_tokens": "0",
15     "num_records": 5000,
16     "num_successful_records": 8,
17     "num_failed_records": 0
18   }
19 }

Retrieves a batch

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path Parameters

idstringRequired

The batch ID.

Response

A successful response.

batchobject

Information about the batch.

Retrieve a batch

Authentication

Path Parameters

Headers

Response

Errors