---
title: "Get information about a call"
method: GET
path: "/calling/v1/calls/id/{callId}"
tags: ["Calls"]
---

# Get information about a call

`GET /calling/v1/calls/id/{callId}`

## Request

- Base URL: `https://calling.api.sinch.com`
- URL: `https://calling.api.sinch.com/calling/v1/calls/id/{callId}`
- Auth: one of:
  - HTTP basic
  - API key in header `Authorization`

You can retrieve information about an ongoing or completed call using a call ID. You can find the call ID of an ongoing call by viewing the response object from a callout request. You can find the call ID of a completed call by looking at your call logs in your Sinch [Dashboard](https://dashboard.sinch.com/voice/logs).

Note: You can only use this method for calls that terminate to PSTN or SIP networks from an In-app call.

## Response `200`

A success response, or an [Error](https://developers.sinch.com/docs/voice/api-reference/errors/).

- GetCallResponseObj
  - `from` union
    - DestinationMxp: The type of device and number or endpoint to call.
      - `type` 'username' | 'Username', required: Type `userName` used for data endpoints.
      - `endpoint` string, user name, required: For type `userName` the value is the username for a data endpoint.
    - DestinationPstn: The type of device and number or endpoint to call.
      - `type` 'number' | 'Number', required: Type `number` used for PSTN endpoints.
      - `endpoint` string, e164 for numbers, required: If the type is `number` the value of the endpoint is a phone number.
    - DestinationSip: The type of device and number or endpoint to call.
      - `type` 'sip', required: Type `sip` for SIP infrastructures.
      - `endpoint` string, sip address, required: For type `sip` the value is the SIP address for a SIP endpoint.
  - `to` union
    - DestinationMxp: The type of device and number or endpoint to call.
      - `type` 'username' | 'Username', required: Type `userName` used for data endpoints.
      - `endpoint` string, user name, required: For type `userName` the value is the username for a data endpoint.
    - DestinationPstn: The type of device and number or endpoint to call.
      - `type` 'number' | 'Number', required: Type `number` used for PSTN endpoints.
      - `endpoint` string, e164 for numbers, required: If the type is `number` the value of the endpoint is a phone number.
    - DestinationSip: The type of device and number or endpoint to call.
      - `type` 'sip', required: Type `sip` for SIP infrastructures.
      - `endpoint` string, sip address, required: For type `sip` the value is the SIP address for a SIP endpoint.
  - `domain` 'pstn': Must be `pstn` for PSTN.
  - `callId` string: The unique identifier of the call.
  - `duration` integer: The duration of the call in seconds.
  - `status` 'ONGOING' | 'FINAL': The status of the call. Either `ONGOING` or `FINAL`
  - `result` 'N/A' | 'ANSWERED' | 'BUSY' | 'NOANSWER' | 'FAILED': Contains the result of a call.
  - `reason` 'N/A' | 'TIMEOUT' | 'CALLERHANGUP' | 'CALLEEHANGUP' | 'BLOCKED' | 'NOCREDITPARTNER' | 'MANAGERHANGUP' | 'CANCEL' | 'GENERALERROR' | 'INVALIDSVAMLACTION': Contains the reason why a call ended.
  - `timestamp` string, date-time: The date and time of the call.
  - `custom` string: A string that can be used to pass custom information related to the call.
  - `userRate` Price
    - `currencyId` string, nullable
    - `amount` number, float
  - `debit` Price
    - `currencyId` string, nullable
    - `amount` number, float

---

[API](https://skmtc.dev/sinch/apis/voice-api-sinch.md) - [All operations](https://skmtc.dev/sinch/apis/voice-api-sinch/llms.txt) - [OpenAPI document](https://skmtc.dev/sinch/apis/voice-api-sinch/revisions/f5275c330844?raw)