Get a call

The call’s current status and, once it has ended, its duration, recording and outcome.

Scope: calls:read.

GET /calls/{id}

Get a call

cURL

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

200

Example

{
  "id": "call_6f1d2c9a8b7e4f3a2d1c0b9a",
  "object": "call",
  "status": "completed",
  "agent_id": "17ea33d2-5b6c-4c1e-9a1f-2d4e6f8a9b0c",
  "phone_number": "[phone]",
  "contact": {
    "name": "Asha Verma",
    "email": "[e-mail]",
    "external_id": "lead-8812"
  },
  "variables": {
    "course": "NEET 2027",
    "city": "Indore"
  },
  "metadata": {
    "crm_owner": "u_42"
  },
  "batch_id": null,
  "test": false,
  "duration_seconds": 142,
  "created_at": "2026-10-13T09:30:02Z",
  "dialed_at": "2026-10-13T09:30:03Z",
  "ended_at": "2026-10-13T09:32:31Z",
  "recording_url": "https://media.example-cdn.com/recordings/abc.mp3?X-Amz-Signature=…",
  "recording_expires_at": "2026-10-14T09:40:00Z",
  "outcome": {
    "disposition": "Interested",
    "summary": "Asha wants the NEET 2027 weekend batch and asked for the fee structure on WhatsApp.",
    "answers": {
      "Which course are you interested in?": "NEET 2027",
      "Preferred batch timing?": "Weekends"
    },
    "lead_rating": 8,
    "callback_requested": true,
    "callback_time_text": "tomorrow after 6 pm",
    "follow_up": "CALL",
    "follow_up_note": "Send the fee structure; call back tomorrow evening.",
    "meeting": {
      "requested": true,
      "at": "2026-10-14T18:00:00+05:30",
      "time_text": "tomorrow after 6 pm",
      "type": "call"
    },
    "transcript": [
      {
        "speaker": "agent",
        "text": "Hi Asha, this is Riya from Shiksha Academy. Is this a good time?"
      },
      {
        "speaker": "contact",
        "text": "Yes, tell me."
      }
    ]
  }
}

Authorizations

X-API-Key · string · header · required

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

Path Parameters

id · string · required

Response

200

application/json

The call.

id · string

Example:

"call_6f1d2c9a8b7e4f3a2d1c0b9a"

object · string

Allowed value: "call"

status · enum<string>

Available options: queued, dialing, in_progress, completed, no_answer, busy, failed, canceled, expired

status_reason · string

Why a call is waiting or did not happen, in plain words. Present only when there is one.

scheduled_for · string<date-time>

Present while a queued call is held until a later time (outside calling hours, a recall gap, the daily limit).

agent_id · string

phone_number · string

contact · object

Show child attributes

variables · object

metadata · object

batch_id · string | null

test · boolean

duration_seconds · integer | null

created_at · string<date-time>

dialed_at · string<date-time> | null

ended_at · string<date-time> | null

recording_url · string | null

A temporary link to the recording. Fetch the call again for a fresh link after recording_expires_at.

recording_expires_at · string<date-time> | null

outcome · object | null

What the AI took from the conversation. null until it has been processed (usually within a minute of the call ending), and for calls that did not connect.

Show child attributes

idempotent_replay · boolean

Only on POST /calls: true when this is the call created by an earlier request with the same Idempotency-Key.