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

# Get a call

`GET /api/v1/calls/{id}`

Returns a single call, including its status, duration, and transcript (once available).

## Path parameters

- `id` string, required

## Headers

- `Authorization` string, required

## Response `200`

The call.

- CallsGetCallResponse200
  - `call` Call
    - `id` string
    - `phoneNumberId` string
    - `from` string
    - `to` string
    - `direction` 'inbound' | 'outbound'
    - `status` string
    - `duration` integer — Call duration in seconds.
    - `transcript` string, nullable — Transcript text, available after the call ends.
    - `voiceRuntime` 'managed' | 'self-hosted-audio' — Which voice runtime served this call. `managed` — Dial's voice agent ran the call; this includes Self-Hosted's LLM mode, where Dial still handles the audio and only the LLM is yours. `self-hosted-audio` — the call's raw audio was streamed to your own server, so Dial never heard the conversation and produced no transcript or recording for it — `transcript` is always `null`. See the [Self-Hosted guide](/documentation/platform/self-hosted). Null on calls that predate this field.
    - `instruction` string, nullable — The system prompt the AI voice agent ran with for this call. For outbound calls, this is the `outboundInstruction` passed to `POST /api/v1/calls`. For inbound calls, this is a snapshot of the destination number's `inboundInstruction` at the moment the call was answered — later edits to the number do not retroactively change it.
    - `transferTo` string, nullable — Forward-to number (E.164) requested when the call was placed, or `null` when no transfer was requested. See the `transferTo` field on `POST /api/v1/calls`.
    - `transferredAt` string, date-time, nullable — Timestamp of the moment the call was cold-transferred to `transferTo`, or `null` if no hand-off occurred.
    - `createdAt` string, date-time

## Other responses

- `401` — Missing or invalid API key.
- `404` — The requested resource was not found on this account.

---

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