Skip to main content
GET
/
v2
/
batches
/
{batch_id}
/
logs
Get Batch Logs
curl --request GET \
  --url https://api.bland.ai/v2/batches/{batch_id}/logs \
  --header 'authorization: <authorization>'
{
  "data": [
    {
      "id": "6398342c-d7de-4a11-ba86-3d86e5746699",
      "batch_id": "f6ef9224-0ec3-43e4-98a1-bb2a8765d110",
      "org_id": "f52eb4b2-c8b6-44a6-a36c-2749aa930c86",
      "event_type": "complete",
      "timestamp": "2025-05-08T19:28:42.748Z",
      "payload": {
        "calls_total": 1,
        "calls_failed": 0,
        "calls_successful": 1
      }
    },
    {
      "id": "a24616b4-be8f-42e4-be29-4c5ec005756c",
      "batch_id": "f6ef9224-0ec3-43e4-98a1-bb2a8765d110",
      "org_id": "f52eb4b2-c8b6-44a6-a36c-2749aa930c86",
      "event_type": "lifecycle",
      "timestamp": "2025-05-08T19:28:15.560Z",
      "payload": {
        "message": "Requested: 1. Validated: 1. Dispatched: 1. CPS: 1.12.",
        "state_change": "in_progress"
      }
    }
  ],
  "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.

​
Path Parameters

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

​
Query Parameters

​
take
integer
Optional. The number of log entries to return.
​
skip
integer
Optional. The number of log entries to skip (used for pagination).
​
direction
string
Optional. Sort order of logs.
Valid values: "asc" or "desc" (default is "desc").

​
Response

​
data
array
A list of log entries related to the batch’s lifecycle and execution.
​
data[].id
string
The unique identifier for the log entry.
​
data[].batch_id
string
The ID of the batch associated with the log.
​
data[].org_id
string
The organization ID tied to the batch.
​
data[].event_type
string
The type of log event.

Examples: "lifecycle", "complete"
​
data[].timestamp
string (ISO 8601)
The time the log was generated.
​
data[].payload
object
Additional information related to the event. Contents vary depending on the event_type.
​
errors
null
Always null on success.
{
  "data": [
    {
      "id": "6398342c-d7de-4a11-ba86-3d86e5746699",
      "batch_id": "f6ef9224-0ec3-43e4-98a1-bb2a8765d110",
      "org_id": "f52eb4b2-c8b6-44a6-a36c-2749aa930c86",
      "event_type": "complete",
      "timestamp": "2025-05-08T19:28:42.748Z",
      "payload": {
        "calls_total": 1,
        "calls_failed": 0,
        "calls_successful": 1
      }
    },
    {
      "id": "a24616b4-be8f-42e4-be29-4c5ec005756c",
      "batch_id": "f6ef9224-0ec3-43e4-98a1-bb2a8765d110",
      "org_id": "f52eb4b2-c8b6-44a6-a36c-2749aa930c86",
      "event_type": "lifecycle",
      "timestamp": "2025-05-08T19:28:15.560Z",
      "payload": {
        "message": "Requested: 1. Validated: 1. Dispatched: 1. CPS: 1.12.",
        "state_change": "in_progress"
      }
    }
  ],
  "errors": null
}