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
}

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
}