List call history

GET

/api/calls

Get call history with optional filtering by status, direction, agent, and date range.

Status types:

completed - Call ended normally

transferred - Call was transferred to a human agent

in_progress - Call is currently active

failed - Call failed to connect or errored

Request

Authorization

API Key

Add parameter in header

X-API-Key

Example:

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

Query Params

Responses

🟢200

application/json

List of calls

Body

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://snakk-backend-production.up.railway.app/api/calls?status&direction&agent_id&limit&offset' \
--header 'X-API-Key: <api-key>'

Response Example

{
    "calls": [
        {
            "id": "uuid",
            "phone_number": "+4712345678",
            "direction": "inbound",
            "status": "transferred",
            "transfer_destination": "+4798765432",
            "duration_seconds": 120,
            "minutes_billed": 2,
            "started_at": "2024-01-15T10:30:00Z",
            "ended_at": "2024-01-15T10:32:00Z",
            "agent": {
                "id": "uuid",
                "name": "Support Agent"
            }
        }
    ]
}

Modified at 2025-12-17 20:24:06

Start outbound call with ad-hoc agent config (JSON)

Get call details