List calls

Your calls, newest first. Filter by batch, by your external_id, or by creation time; page with starting_after.

Scope: calls:read.

GET /calls

List calls

cURL

curl --request GET \
  --url https://api.telleo.ai/v1/calls \
  --header 'X-API-Key: <api-key>'

200

Example

{
  "object": "list",
  "data": [
    {
      "id": "call_6f1d2c9a8b7e4f3a2d1c0b9a",
      "object": "call",
      "status": "queued",
      "status_reason": "<string>",
      "scheduled_for": "2023-11-07T05:31:56Z",
      "agent_id": "<string>",
      "phone_number": "<string>",
      "contact": {
        "name": "<string>",
        "email": "[e-mail]",
        "external_id": "<string>"
      },
      "variables": {},
      "metadata": {},
      "batch_id": "<string>",
      "test": true,
      "duration_seconds": 123,
      "created_at": "2023-11-07T05:31:56Z",
      "dialed_at": "2023-11-07T05:31:56Z",
      "ended_at": "2023-11-07T05:31:56Z",
      "recording_url": "<string>",
      "recording_expires_at": "2023-11-07T05:31:56Z",
      "outcome": {
        "disposition": "<string>",
        "summary": "<string>",
        "answers": {},
        "lead_rating": 5,
        "callback_requested": true,
        "callback_time_text": "<string>",
        "follow_up": "CALL",
        "follow_up_note": "<string>",
        "meeting": {
          "requested": true,
          "at": "<string>",
          "time_text": "<string>",
          "type": "<string>"
        },
        "transcript": [
          {
            "speaker": "agent",
            "text": "<string>"
          }
        ]
      },
      "idempotent_replay": true
    }
  ],
  "has_more": true
}

Authorizations

X-API-Key · string · header · required

Your AI calling API key (vak_call_…). Authorization: Bearer <key> also works.

Query Parameters

batch_id · string

external_id · string

Calls for one of your records.

created_after · string<date-time>

ISO-8601 instant, e.g. 2026-10-13T09:00:00Z.

limit · integer · default: 25

Required range: 1 <= x <= 100

starting_after · string

The id of the last call on the previous page.

Response

200

application/json

A page of calls.

object · string

Allowed value: "list"

data · object[]

Show child attributes

has_more · boolean