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

<ParamField header="authorization" type="string" required>
  Your API key for authentication.
</ParamField>

### Query Parameters

**Pagination**

<ParamField query="page" type="integer">
  Page number. Defaults to `1`.
</ParamField>

<ParamField query="pageSize" type="integer">
  Results per page. Maximum `100`. Defaults to `50`.
</ParamField>

**Filters**

<ParamField query="tool_id" type="string">
  Filter logs by a specific tool ID.
</ParamField>

<ParamField query="resource_id" type="string">
  Filter logs by a specific resource ID.
</ParamField>

<ParamField query="integration" type="string">
  Filter logs by integration key (e.g. `"slack"`).
</ParamField>

<ParamField query="action" type="string">
  Filter logs by action name.
</ParamField>

<ParamField query="status" type="string">
  Filter by execution status. Allowed values: `"success"`, `"error"`.
</ParamField>

<ParamField query="call_id" type="string">
  Filter logs by the call ID that triggered the tool execution.
</ParamField>

<ParamField query="error_type" type="string">
  Filter logs by error type (only applies to failed executions).
</ParamField>

**Date Range**

<ParamField query="created_after" type="string">
  ISO 8601 date string. Only return logs created after this timestamp.
</ParamField>

<ParamField query="created_before" type="string">
  ISO 8601 date string. Only return logs created before this timestamp.
</ParamField>

**Size Filters**

<ParamField query="execution_time_ms_gt" type="number">
  Only return logs where execution time is greater than this value (in ms).
</ParamField>

<ParamField query="execution_time_ms_lt" type="number">
  Only return logs where execution time is less than this value (in ms).
</ParamField>

<ParamField query="input_size_kb_gt" type="number">
  Only return logs where input payload size is greater than this value (in KB).
</ParamField>

<ParamField query="input_size_kb_lt" type="number">
  Only return logs where input payload size is less than this value (in KB).
</ParamField>

<ParamField query="output_size_kb_gt" type="number">
  Only return logs where output payload size is greater than this value (in KB).
</ParamField>

<ParamField query="output_size_kb_lt" type="number">
  Only return logs where output payload size is less than this value (in KB).
</ParamField>

### Response

<ResponseField name="logs" type="array">
  Array of tool execution log entries.

  <Expandable title="log entry">
    <ResponseField name="id" type="string">
      Unique log entry identifier.
    </ResponseField>

    <ResponseField name="tool_id" type="string">
      ID of the tool that was executed.
    </ResponseField>

    <ResponseField name="resource_id" type="string">
      ID of the resource used, if any.
    </ResponseField>

    <ResponseField name="integration" type="string">
      Integration key that was invoked.
    </ResponseField>

    <ResponseField name="action" type="string">
      Action that was invoked.
    </ResponseField>

    <ResponseField name="status" type="string">
      Execution result: `"success"` or `"error"`.
    </ResponseField>

    <ResponseField name="call_id" type="string">
      ID of the call that triggered this execution.
    </ResponseField>

    <ResponseField name="execution_time_ms" type="number">
      Time taken to execute the tool in milliseconds.
    </ResponseField>

    <ResponseField name="input_size_kb" type="number">
      Size of the input payload in KB.
    </ResponseField>

    <ResponseField name="output_size_kb" type="number">
      Size of the output payload in KB.
    </ResponseField>

    <ResponseField name="error_type" type="string">
      Error category if the execution failed.
    </ResponseField>

    <ResponseField name="created_at" type="string">
      ISO 8601 timestamp of when the execution occurred.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="totalLogs" type="number">
  Total number of logs matching the filters.
</ResponseField>

<ResponseField name="totalPages" type="number">
  Total number of pages.
</ResponseField>

<ResponseField name="currentPage" type="number">
  The current page number.
</ResponseField>

<ResponseField name="pageSize" type="number">
  Number of results per page.
</ResponseField>

<ResponseExample>
  ```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
  }
  ```
</ResponseExample>

***

Docs for agents: [llms.txt](/llms.txt)