List calls

GET

/api/calls

Returns a paginated list of calls for the authenticated tenant, newest first. Anonymized/erased calls are excluded. Supports filtering by status and searching by phone number across the full retention window.

Request

Authorization

API Key

Add parameter in header

X-API-Key

Example:

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

Query Params

Responses

🟢200

application/json

List of calls.

Bodyapplication/json

🟠401Unauthorized

🔴500ServerError

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.snakk.ai/api/calls?limit=&offset=&status=&search=' \
--header 'X-API-Key: <api-key>'

Response Example

200 - Success

{
    "calls": [
        {
            "id": "a1b2c3d4-0000-0000-0000-000000000000",
            "tenant_id": "11111111-1111-1111-1111-111111111111",
            "agent_id": "22222222-2222-2222-2222-222222222222",
            "phone_number": "+4799999999",
            "direction": "inbound",
            "status": "completed",
            "room_name": "call-1700000000000-abc123",
            "started_at": "2026-06-25T09:00:00.000Z",
            "ended_at": "2026-06-25T09:03:21.000Z",
            "duration_seconds": 201,
            "minutes_billed": 3.35,
            "agent": {
                "name": "Reception",
                "phone_number": "+4711111111"
            }
        }
    ]
}

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

Delete tool

Start an outbound call