Tool Execution Logs

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

GET /v2/tools/logs

Tool Execution Logs

cURL

curl --request GET \
  --url https://api.bland.ai/v2/tools/logs \
  --header 'authorization: <authorization>'

Response (Success)

{
  "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
}

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.

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

Response (Success)

{
  "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