> ## 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.

# Get Batch Logs

> Retrieve logs for a specific batch.

### 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.

```json Response theme={null}
{
  "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
}
```

***

Docs for agents: [llms.txt](https://docs.bland.ai/llms.txt)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.