---
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}`

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.net/sinch/apis/voice-api-sinch.md) · [All operations](https://skmtc.net/sinch/apis/voice-api-sinch/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sinch/voice-api-sinch/revisions/a59ac1ee7b2c/schema)