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

# Get a call

`GET /calls/{call_id}`

Retrieve a single call by id.

## Path parameters

- `call_id` string, required

## Headers

- `Intercom-Version` '1.0' | '1.1' | '1.2' | '1.3' | '1.4' | '2.0' | '2.1' | '2.2' | '2.3' | '2.4' | '2.5' | '2.6' | '2.7' | '2.8' | '2.9' | '2.10' | '2.11' | '2.12' | '2.13' | '2.14' — Intercom API version.</br>By default, it's equal to the version set in the app package.

## Response `200`

successful

- Call — Represents a phone call in Intercom
  - `type` string — String representing the object's type. Always has the value `call`.
  - `id` string — The id of the call.
  - `conversation_id` string, nullable — The id of the conversation associated with the call, if any.
  - `admin_id` string, nullable — The id of the admin associated with the call, if any.
  - `contact_id` string, nullable — The id of the contact associated with the call, if any.
  - `state` string — The current state of the call.
  - `initiated_at` union
    - string, date-time — A date and time following the ISO8601 notation.
    - integer — A date and time as UNIX timestamp notation.
  - `answered_at` union
    - string, date-time — A date and time following the ISO8601 notation.
    - integer — A date and time as UNIX timestamp notation.
  - `ended_at` union
    - string, date-time — A date and time following the ISO8601 notation.
    - integer — A date and time as UNIX timestamp notation.
  - `created_at` union
    - string, date-time — A date and time following the ISO8601 notation.
    - integer — A date and time as UNIX timestamp notation.
  - `updated_at` union
    - string, date-time — A date and time following the ISO8601 notation.
    - integer — A date and time as UNIX timestamp notation.
  - `recording_url` string, uri, nullable — API URL to download or redirect to the call recording if available.
  - `transcription_url` string, uri, nullable — API URL to download or redirect to the call transcript if available.
  - `call_type` string — The type of call.
  - `direction` string — The direction of the call.
  - `ended_reason` string, nullable — The reason for the call end, if applicable.
  - `phone` string, nullable — The phone number involved in the call, in E.164 format.
  - `fin_recording_url` string, uri, nullable — API URL to the AI Agent (Fin) call recording if available.
  - `fin_transcription_url` string, uri, nullable — API URL to the AI Agent (Fin) call transcript if available.

## Other responses

- `401` — Unauthorized
- `404` — Not Found

---

[API](https://skmtc.net/intercom/apis/intercom-api.md) · [All operations](https://skmtc.net/intercom/apis/intercom-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/intercom/intercom-api/revisions/9517e80f2642/schema)