Skip to main content
GET
/
v2
/
tools
/
logs
Tool Execution Logs
curl --request GET \
  --url https://api.bland.ai/v2/tools/logs \
  --header 'authorization: <authorization>'
{
  "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.
​
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.
{
  "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
}