GET
/
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
}