Sign in

v51

latestOpenAPI 3.0.1MITraw.githubusercontent.com2026-08-01150230854.3 KB
Calls

Get a call

Retrieve a single call by id.

get/calls/{call_id}

Path parameters

call_idstring required

The id of the call to retrieve

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.

Example:2.14

Response

successful

typestring

String representing the object's type. Always has the value call.

idstring

The id of the call.

conversation_idstring nullable

The id of the conversation associated with the call, if any.

admin_idstring nullable

The id of the admin associated with the call, if any.

contact_idstring nullable

The id of the contact associated with the call, if any.

statestring

The current state of the call.

recording_urlstring uri nullable

API URL to download or redirect to the call recording if available.

transcription_urlstring uri nullable

API URL to download or redirect to the call transcript if available.

call_typestring

The type of call.

directionstring

The direction of the call.

ended_reasonstring nullable

The reason for the call end, if applicable.

phonestring nullable

The phone number involved in the call, in E.164 format.

fin_recording_urlstring uri nullable

API URL to the AI Agent (Fin) call recording if available.

fin_transcription_urlstring uri nullable

API URL to the AI Agent (Fin) call transcript if available.

Example response

{
  "type": "call",
  "id": "123",
  "conversation_id": "456",
  "admin_id": "789",
  "contact_id": "6762f0dd1bb69f9f2193bb83",
  "state": "completed",
  "recording_url": "https://api.intercom.io/calls/123/recording",
  "transcription_url": "https://api.intercom.io/calls/123/transcript",
  "call_type": "phone",
  "direction": "outbound",
  "ended_reason": "completed",
  "phone": "+15551234567"
}