---
title: "Get Call"
method: GET
path: "/v1/get-call/{id}"
---

# Get Call

`GET /v1/get-call/{id}`

Retrieves detailed information about a specific call by its ID, including call metadata, transcript, analysis, and the associated contact.

## Path parameters

- `id` string, uuid, required

## Response `200`

Call retrieved successfully

- object
  - `call` object
    - `call_id` string, uuid — Unique identifier for the call
    - `attempt` number — Which attempt number this call is within its loop
    - `from_number` string — Caller phone number in E.164 format
    - `to_number` string — Callee phone number in E.164 format
    - `direction` string — Call direction: 'inbound' or 'outbound'
    - `external_contact_id` string — Your external identifier for the contact
    - `contact_id` string, uuid — telli contact ID
    - `contact_details` object — Custom variables associated with the contact
    - `agent_id` string, uuid — ID of the agent that handled the call
    - `triggered_at` number — Unix timestamp (ms) when the call was triggered
    - `triggered_at_iso` string — ISO 8601 timestamp when the call was triggered
    - `started_at` number — Unix timestamp (ms) when the call was answered
    - `started_at_iso` string — ISO 8601 timestamp when the call was answered
    - `ended_at` number — Unix timestamp (ms) when the call ended
    - `ended_at_iso` string — ISO 8601 timestamp when the call ended
    - `call_length_min` number — Duration of the call in minutes (rounded up)
    - `call_status` 'COMPLETED' | 'ANSWERED' | 'NOT_REACHED' | 'VOICEMAIL' | 'ERROR' — Deprecated. Use state, status, and follow_up instead.
    - `transcript` string — Plain text transcript of the call
    - `transcriptObject` union[] — Structured transcript as an array of messages
      - union
        - object — A spoken message from the user or agent
          - `role` 'user' | 'agent', required — Who spoke this message
          - `content` string, required — The spoken text
        - object — A tool activity performed by the agent during the call
          - `role` 'agent', required
          - `toolActivity` string, required — Name of the tool that was invoked
          - `toolParameters` object — Parameters passed to the tool
    - `call_analysis` object — AI-generated analysis of the call. Keys are analysis field names configured on the agent.
    - `call_outcome` object — Structured outcome data extracted from the call. Keys are outcome field names configured on the agent.
    - `collected_data` object — Data collected from the contact during the call via tasks (e.g. email, license plate). Keys are task names.
    - `booked_slot_for` string — ISO 8601 timestamp of the booked appointment slot, if any
    - `recording_url` string — URL to the call recording (only available when both parties have given consent)
    - `transfer` object, nullable — Transfer details when the call was transferred, or null if the call was not transferred
      - `destination` string — Transfer target the call was transferred to: an E.164 phone number or a tel:/sip: URI
      - `completed_at` string, nullable — ISO 8601 timestamp of when the call was transferred
    - `ended_reason` 'agent-ended-call' | 'agent-forwarded-call' | 'agent-busy' | 'agent-did-not-answer' | 'contact-busy' | 'contact-ended-call' | 'contact-did-not-answer' | 'phone-provider-closed-connection' | 'other' — Why the call ended
    - `state` 'queued' | 'ringing' | 'in_progress' | 'processing' | 'ended' — Current call lifecycle state
    - `status` 'connected' | 'not_connected' | 'voicemail' | 'failed', nullable — Normalized terminal connection status. Null while the call is not terminal.
    - `follow_up` object, nullable — Scheduled follow-up call information, if the agent scheduled one.
      - `type` 'agent_follow_up', required
      - `scheduled_at` string, date-time, required — When the follow-up call is scheduled
  - `contact` object
    - `contact_id` string, uuid
    - `external_contact_id` string — Your unique internal identifier for the contact
    - `external_url` string — External URL linking to the contact in your CRM
    - `created_at` string — ISO 8601 timestamp when the contact was created
    - `gender` string
    - `first_name` string
    - `last_name` string
    - `phone_number` string — Phone number in E.164 format
    - `in_call_since` string — ISO 8601 timestamp if the contact is currently in a call
    - `reached_at` string — ISO 8601 timestamp when the contact was last reached
    - `contact_details` object — Custom variables associated with the contact
    - `call_attempts` number — Number of call attempts made to this contact
    - `next_call_at` string — ISO 8601 timestamp of the next scheduled call
    - `email` string
    - `timezone` string — IANA timezone identifier (e.g. Europe/Berlin)
    - `salutation` string — Formal title or greeting (e.g. 'Mr.', 'Ms.')
    - `status` 'new' | 'pending' | 'closed' | 'reached' — Contact status

## Other responses

- `400` — Invalid request - id must be a valid UUID
- `401` — Unauthorized - Invalid API key
- `404` — Call not found

---

[API](https://skmtc.dev/telli/apis/telli-api.md) · [All operations](https://skmtc.dev/telli/apis/telli-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/telli/telli-api/revisions/9815a3c63c75/schema)