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

# Tool Execution Logs

> Retrieve per-execution logs for your tools with optional filtering and pagination.

### Headers

**authorization** `string` *required*

Your API key for authentication.

### Query Parameters

**Pagination**

**page** `integer`

Page number. Defaults to `1`.

**pageSize** `integer`

Results per page. Maximum `100`. Defaults to `50`.

**Filters**

**tool\_id** `string`

Filter logs by a specific tool ID.

**resource\_id** `string`

Filter logs by a specific resource ID.

**integration** `string`

Filter logs by integration key (e.g. `"slack"`).

**action** `string`

Filter logs by action name.

**status** `string`

Filter by execution status. Allowed values: `"success"`, `"error"`.

**call\_id** `string`

Filter logs by the call ID that triggered the tool execution.

**error\_type** `string`

Filter logs by error type (only applies to failed executions).

**Date Range**

**created\_after** `string`

ISO 8601 date string. Only return logs created after this timestamp.

**created\_before** `string`

ISO 8601 date string. Only return logs created before this timestamp.

**Size Filters**

**execution\_time\_ms\_gt** `number`

Only return logs where execution time is greater than this value (in ms).

**execution\_time\_ms\_lt** `number`

Only return logs where execution time is less than this value (in ms).

**input\_size\_kb\_gt** `number`

Only return logs where input payload size is greater than this value (in KB).

**input\_size\_kb\_lt** `number`

Only return logs where input payload size is less than this value (in KB).

**output\_size\_kb\_gt** `number`

Only return logs where output payload size is greater than this value (in KB).

**output\_size\_kb\_lt** `number`

Only return logs where output payload size is less than this value (in KB).

### Response

**logs** `array`

Array of tool execution log entries.

**log entry**

**id** `string`

Unique log entry identifier.

**tool\_id** `string`

ID of the tool that was executed.

**resource\_id** `string`

ID of the resource used, if any.

**integration** `string`

Integration key that was invoked.

**action** `string`

Action that was invoked.

**status** `string`

Execution result: `"success"` or `"error"`.

**call\_id** `string`

ID of the call that triggered this execution.

**execution\_time\_ms** `number`

Time taken to execute the tool in milliseconds.

**input\_size\_kb** `number`

Size of the input payload in KB.

**output\_size\_kb** `number`

Size of the output payload in KB.

**error\_type** `string`

Error category if the execution failed.

**created\_at** `string`

ISO 8601 timestamp of when the execution occurred.

**totalLogs** `number`

Total number of logs matching the filters.

**totalPages** `number`

Total number of pages.

**currentPage** `number`

The current page number.

**pageSize** `number`

Number of results per page.

```json Response (Success) theme={null}
{
  "logs": [
    {
      "id": "log_abc123",
      "tool_id": "TL-abc123def456",
      "resource_id": null,
      "integration": "slack",
      "action": "send_message",
      "status": "success",
      "call_id": "call_xyz789",
      "execution_time_ms": 342,
      "input_size_kb": 0.5,
      "output_size_kb": 1.2,
      "error_type": null,
      "created_at": "2025-09-23T15:13:36.348Z"
    }
  ],
  "totalLogs": 1,
  "totalPages": 1,
  "currentPage": 1,
  "pageSize": 50
}
```

***

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.