Skip to main content
GET
https://api.bland.ai
/
v2
/
batches
/
{batch_id}
Get Batch
curl --request GET \
  --url https://api.bland.ai/v2/batches/{batch_id} \
  --header 'authorization: <authorization>'
{
  "data": {
    "id": "a9a033b7-44d8-40c6-aaec-42cd43106273",
    "user_id": "657ad643-92ca-477c-97cc-9d8e6e74d7af",
    "base_prompt": "{\"record\":true,\"task\":\"Say hello to the user\"}",
    "created_at": "2025-05-08T19:28:12.627Z",
    "call_objects": [
      {
        "task": "Say hello to the user",
        "phone_number": "+1234567890"
      }
    ],
    "description": "Untitled Batch"
  },
  "errors": null
}

​
Headers

​
authorization
string
required
Your API key for authentication.

​
Path Parameters

​
batch_id
string
required
The unique identifier of the batch you want to fetch.

​
Response

​
data
object
Metadata and configuration details of the batch.
​
data.id
string
The unique identifier of the batch.
​
data.user_id
string
The ID of the org that created the batch.
​
data.base_prompt
string
A JSON string representing shared call properties such as task or record.
​
data.created_at
string (ISO 8601)
The timestamp of when the batch was created.
​
data.call_objects
array
A preview of call objects in the batch.
​
data.description
string
A human-readable label or description for the batch.
​
errors
null
Always null on success.
{
  "data": {
    "id": "a9a033b7-44d8-40c6-aaec-42cd43106273",
    "user_id": "657ad643-92ca-477c-97cc-9d8e6e74d7af",
    "base_prompt": "{\"record\":true,\"task\":\"Say hello to the user\"}",
    "created_at": "2025-05-08T19:28:12.627Z",
    "call_objects": [
      {
        "task": "Say hello to the user",
        "phone_number": "+1234567890"
      }
    ],
    "description": "Untitled Batch"
  },
  "errors": null
}