GET
/
v2
/
batches
/
list
curl --request GET \
  --url https://api.bland.ai/v2/batches/list \
  --header 'authorization: <authorization>'
{
  "data": [
    {
      "id": "652ad643-9gca-477c-97c3-9d8e6t74d7af",
      "user_id": "64602f94-d670-43d2-8474-bcdcb9522c4f",
      "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": "My first batch"
    }
  ],
  "errors": null
}

​
Headers

​
authorization
string
required

Your API key for authentication.

​
Query Parameters

​
take
integer

Optional. The number of results to return.

​
skip
integer

Optional. The number of results to skip (used for pagination).

​
Response

​
data
array

A list of batches created by your organization.

​
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 the global call properties used in the batch.

​
data[].created_at
string (ISO 8601)

The timestamp when the batch was created.

​
data[].call_objects
array

A preview of the call objects included in the batch.

​
data[].description
string

A human-readable description of the batch.

​
errors
null

Always null on success.

{
  "data": [
    {
      "id": "652ad643-9gca-477c-97c3-9d8e6t74d7af",
      "user_id": "64602f94-d670-43d2-8474-bcdcb9522c4f",
      "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": "My first batch"
    }
  ],
  "errors": null
}