Skip to main content
GET
/
v2
/
batches
/
list
List Batches
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
}

Documentation Index

Fetch the complete documentation index at: https://docs.bland.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
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
}