---
title: "Get a call"
method: GET
path: "/calls/{call_id}"
tags: [""]
---

# Get a call

`GET /calls/{call_id}`

Retrieve the transcript and other metadata for a phone call.

## Path parameters

- `call_id` string, required — Call ID. You can find it on the logs page in your dashboard.

## Headers

- `Authorization` string, required

## Response `200`

200

- GetPhoneCallResponse200
  - `status` string — Whether the request was successful.
  - `response` CallsCallIdGetResponsesContentApplicationJsonSchemaResponse
    - `pagination` CallsCallIdGetResponsesContentApplicationJsonSchemaResponsePagination — Pagination information for the results.
      - `total_records` integer — The total number of call records matching the query.
      - `limit` integer — The maximum number of records returned per request.
      - `offset` integer — The number of records skipped from the beginning of the results.
    - `calls` CallsCallIdGetResponsesContentApplicationJsonSchemaResponseCallsItems[]
      - `call_id` string — Call ID. You can find it on the logs page in your dashboard.
      - `model_id` string — Agent ID. You can find it on the agent’s page in your dashboard.
      - `campaign_type` string — Campaign type.
      - `phone_number_from` string — The caller's phone number.
      - `phone_number_to` string — The call recipient's phone number.
      - `name` string — Recipient's name.
      - `transcript` string — Call transcript.
      - `duration` integer — The duration of the call in seconds.
      - `recording_url` string, nullable — The URL of the call recording, or `null` if no recording is available.
      - `end_call_reason` 'human_pick_up_cut_off' | 'voicemail' | 'voicemail_cut_off' | 'voicemail_message_left' | 'agent_ended_call' | 'human_ended_call' | 'custom_end_call' | 'user_canceled' | 'timeout' | 'error' — The reason the call ended from the AI agent's perspective.
      - `custom_end_call_reason` string, nullable — The specific user-defined reason that triggered call termination. Only present when end_call_reason is custom_end_call.
      - `error_message` string — Error message if the call encountered an error, or an empty string if no error occurred.
      - `executed_actions` CallsCallIdGetResponsesContentApplicationJsonSchemaResponseCallsItemsExecutedActions — Actions that were executed during the call.
      - `prompt_variables` CallsCallIdGetResponsesContentApplicationJsonSchemaResponseCallsItemsPromptVariables — Prompt variables.
      - `type_of_call` 'inbound' | 'outbound' — Call type.
      - `start_time` string — The scheduled start time for the call as a UNIX timestamp in milliseconds.
      - `timezone` string — The timezone of the call. For a list of all available time zones, see the available [timezones](/time-zones).
      - `telephony_hangup` 'caller' | 'callee' — Indicates which party ended the call.
      - `telephony_disconnect_reason` 'unknown' | 'callee_hangup' | 'caller_hangup' | 'error' | 'forbidden' — The reason the telephony connection was disconnected.
      - `telephony_duration` integer — The total duration of the telephony connection in milliseconds.
      - `telephony_ringing_duration` integer — The duration the phone was ringing before the call was answered, in milliseconds.
      - `telephony_start` string, date-time — The timestamp when the telephony connection started (ISO 8601 format).
      - `telephony_end` string, date-time — The timestamp when the telephony connection ended (ISO 8601 format).
      - `status` 'pending' | 'ringing' | 'in-progress' | 'completed' | 'no-answer' | 'busy' | 'failed' | 'canceled' | 'user-canceled' | 'hangup_on_voicemail' | 'left_voicemail' | 'spam' | 'paused' | 'registered' — The current status of the call.
      - `collected_variables` object — Collected variables (slots) from the conversation flow, keyed by agent ID. May be null if not available.

## Other responses

- `400` — 400
- `404` — 404

---

[API](https://skmtc.net/synthflow/apis/platform-api.md) · [All operations](https://skmtc.net/synthflow/apis/platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/synthflow/platform-api/versions/decb652b52e0/schema)