GET
https://api.bland.ai
/
v2
/
batches
/
{batch_id}
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
}