Intercom API (unofficial showcase)
GET/calls/{call_id}

Get a call

Retrieves a single call by its identifier. Use call_id to select the call whose details you need.

2 parameters
call_idstringrequired
The identifier of the call to retrieve.
Intercom-Versionstringoptional
The Intercom API version to use. Defaults to 2.17 when omitted.
Allowed:1.01.11.21.31.42.02.12.22.32.42.52.6Default:2.17

3 status codes
200Returns a call object with call details, including its state, associated conversation or contact when available, timestamps, and recording or transcript URLs when available.
typestringoptional
String representing the object's type. Always has the value `call`.
idstringoptional
The id of the call.
conversation_idstringoptional
The id of the conversation associated with the call, if any.
admin_idstringoptional
The id of the admin associated with the call, if any.
contact_idstringoptional
The id of the contact associated with the call, if any.
statestringoptional
The current state of the call.
initiated_atstringoptional
A date and time following the ISO8601 notation.
answered_atstringoptional
A date and time following the ISO8601 notation.
ended_atstringoptional
A date and time following the ISO8601 notation.
created_atstringoptional
A date and time following the ISO8601 notation.
updated_atstringoptional
A date and time following the ISO8601 notation.
recording_urlstringoptional
API URL to download or redirect to the call recording if available.
transcription_urlstringoptional
API URL to download or redirect to the call transcript if available.
call_typestringoptional
The type of call.
directionstringoptional
The direction of the call.
ended_reasonstringoptional
The reason for the call end, if applicable.
phonestringoptional
The phone number involved in the call, in E.164 format.
fin_recording_urlstringoptional
API URL to the AI Agent (Fin) call recording if available.
fin_transcription_urlstringoptional
API URL to the AI Agent (Fin) call transcript if available.
401Returned when the request is unauthorized.

One documented failure

  • unauthorized

    Access Token Invalid

typestringrequired
The type is error.list
request_idstringoptional
errorsarray<object>required
An array of one or more error objects
404Returned when the call is not found.

One documented failure

  • not_found

    Not Found

typestringrequired
The type is error.list
request_idstringoptional
errorsarray<object>required
An array of one or more error objects

Error handling

A 401 is returned when the request is unauthorized. A 404 is returned when the call identified by the call_id path parameter is not found.