# Get a call

Retrieve a single call by id.
Requires the `read_conversations` OAuth scope.

Endpoint: GET /calls/{id}
Version: Preview
Security: bearerAuth

## Path parameters:

  - `id` (string, required)
    The id of the call to retrieve

## Header parameters:

  - `Intercom-Version` (string)

## Response 200 fields (application/json):

  - `type` (string)
    String representing the object's type. Always has the value `call`.
    Example: call

  - `id` (string)
    The id of the call.
    Example: 123

  - `conversation_id` (string)
    The id of the conversation associated with the call, if any.
    Example: 456

  - `admin_id` (string)
    The id of the admin associated with the call, if any.
    Example: 789

  - `contact_id` (string)
    The id of the contact associated with the call, if any.
    Example: 6762f0dd1bb69f9f2193bb83

  - `state` (string)
    The current state of the call.
    Example: ended

  - `initiated_at` (any)

  - `recording_url` (string)
    API URL to download or redirect to the call recording if available.
    Example: https://api.intercom.io/calls/123/recording

  - `transcription_url` (string)
    API URL to the call transcript if available.
    Example: https://api.intercom.io/calls/123/transcript

  - `call_type` (string)
    The type of call.
    Example: phone

  - `direction` (string)
    The direction of the call.
    Example: outbound

  - `ended_reason` (string)
    The reason for the call end, if applicable.
    Example: missed

  - `phone` (string)
    The phone number involved in the call, in E.164 format.
    Example: +15551234567

  - `fin_recording_url` (string)
    API URL to the AI Agent (Fin) call recording if available.

  - `fin_transcription_url` (string)
    API URL to the AI Agent (Fin) call transcript if available.

  - `duration` (integer)
    Total call duration in seconds from the caller's perspective. For inbound calls, measured from initiated to ended. For outbound calls, measured from answered to ended. Null until the call ends, and for outbound calls that were never answered.
    Example: 900

  - `talk_time` (integer)
    Total time in seconds the agent and customer were connected.
    Example: 300

  - `queue_time` (integer)
    Total time in seconds the caller waited in queue before connecting, when assigned to a team.
    Example: 45

  - `hold_time` (integer)
    Total time in seconds the caller was placed on hold during the call.
    Example: 60

## Response 401 fields (application/json):

  - `type` (string, required)
    The type is error.list
    Example: error.list

  - `request_id` (string)
    Example: f93ecfa8-d08a-4325-8694-89aeb89c8f85

  - `errors` (array, required)
    An array of one or more error objects

  - `errors.code` (any, required)
    A string indicating the kind of error, used to further qualify the HTTP response code. A few request validation errors send an HTTP status code as an integer here instead, for example `422`.
    Example: unauthorized

  - `errors.message` (string)
    Optional. Human readable description of the error.
    Example: Access Token Invalid

## Response 404 fields (application/json):

  - `type` (string, required)
    The type is error.list
    Example: error.list

  - `request_id` (string)
    Example: f93ecfa8-d08a-4325-8694-89aeb89c8f85

  - `errors` (array, required)
    An array of one or more error objects

  - `errors.code` (any, required)
    A string indicating the kind of error, used to further qualify the HTTP response code. A few request validation errors send an HTTP status code as an integer here instead, for example `422`.
    Example: unauthorized

  - `errors.message` (string)
    Optional. Human readable description of the error.
    Example: Access Token Invalid