GET
/
v2
/
batches
/
{batch_id}
/
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.