List tool call logs

GET

/api/tool-logs

Returns a paginated list of tool/integration call logs for the authenticated tenant, newest first. Supports filtering by agent, call, tool name, success state, and start date.

Request

Authorization

API Key

Add parameter in header

X-API-Key

Example:

X-API-Key: ********************

Query Params

Responses

🟢200

application/json

List of tool call logs.

Bodyapplication/json

🟠401

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.snakk.ai/api/tool-logs?agent_id=&call_id=&tool_name=&success=&since=&limit=&offset=' \
--header 'X-API-Key: <api-key>'

Response Example

200 - Success

{
    "logs": [
        {
            "id": "8f1c2e3a-4b5d-6e7f-8a9b-0c1d2e3f4a5b",
            "tenant_id": "11111111-2222-3333-4444-555555555555",
            "agent_id": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
            "call_id": "99999999-8888-7777-6666-555555555555",
            "tool_name": "book_appointment",
            "tool_type": "webhook",
            "webhook_url": "https://example.com/hooks/booking",
            "request_method": "POST",
            "request_headers": {
                "content-type": "application/json"
            },
            "request_body": {
                "date": "2026-07-01",
                "name": "Example AS"
            },
            "response_status": 200,
            "response_body": {
                "ok": true
            },
            "response_time_ms": 412,
            "success": true,
            "error_message": null,
            "room_name": "room-abc123",
            "phone_number": "+4740000000",
            "created_at": "2026-06-25T09:12:00.000Z",
            "agent": {
                "name": "Reception"
            },
            "call": {
                "phone_number": "+4740000000",
                "started_at": "2026-06-25T09:10:00.000Z"
            }
        }
    ],
    "count": 1
}

Modified at 2026-07-08 19:01:40

Check if verification is required

Tool usage statistics