List calls

Retrieve call history with optional filtering by status and date range. Returns complete call data including transcripts, analysis results, and metadata.

Authorization

BearerAuth

AuthorizationBearer <token>

API key authentication. Get your key from the dashboard.

In: header

Query Parameters

limit?integer

Maximum number of results (max 1000)

Default100

Rangevalue <= 1000

offset?integer

Number of results to skip

Default0

status?string

Filter by call status

Value in"connecting" | "in-progress" | "ended" | "failed"

start_date?string

Filter calls from this date (ISO 8601)

Formatdate-time

end_date?string

Filter calls until this date (ISO 8601)

Formatdate-time

Response Body

`application/json`

curl -X GET "https://example.com/calls"

{
  "calls": [
    {
      "id": "call-_+31623731537_XqaQxRRgAzYc",
      "caller_phone": "+31623731537",
      "assistant_phone": "+31850835037",
      "status": "ended",
      "error": "string",
      "started_at": "2019-08-24T14:15:22Z",
      "ended_at": "2019-08-24T14:15:22Z",
      "duration_seconds": 120,
      "summary": "string",
      "analysis_result": {
        "summary": "string",
        "sentiment": 8
      },
      "messages": [
        {
          "role": "assistant",
          "content": "Hello, how can I help you?"
        },
        {
          "role": "user",
          "content": "Hi, can you hear me?"
        }
      ],
      "agent_id": "2b1e3b65-2c04-4fa2-a2d7-467901e98978",
      "number_id": "7f8a9b2c-3d4e-5f6g-7h8i-9j0k1l2m3n4o",
      "agent_name": "string",
      "business_name": "string",
      "phone_number": "+31850835037",
      "created_at": "2019-08-24T14:15:22Z",
      "updated_at": "2019-08-24T14:15:22Z"
    }
  ],
  "pagination": {
    "total": 42,
    "limit": 100,
    "offset": 0
  }
}

{
  "error": "Invalid API key",
  "message": "string"
}

Authorization

Query Parameters

Response Body

200application/json

401application/json

`application/json`

`application/json`