---
title: "Get Call Session Status"
method: GET
path: "/restapi/v1.0/account/{accountId}/telephony/sessions/{telephonySessionId}"
tags: ["Call Control"]
---

# Get Call Session Status

`GET /restapi/v1.0/account/{accountId}/telephony/sessions/{telephonySessionId}`

## Request

- Base URL: `https://platform.ringcentral.com`
- URL: `https://platform.ringcentral.com/restapi/v1.0/account/{accountId}/telephony/sessions/{telephonySessionId}`
- Auth: OAuth 2
  - Authorization code: `https://platform.ringcentral.com/restapi/oauth/authorize`
  - Token URL: `https://platform.ringcentral.com/restapi/oauth/token`
- TypeScript: <https://skmtc.dev/ringcentral/apis/ringcentral-api/docs/restapi/v1.0/account/:accountId/telephony/sessions/:telephonySessionId/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns the status of a call session by ID.

## Path parameters

- `accountId` string, required
- `telephonySessionId` string, required

## Query parameters

- `timestamp` string
- `timeout` string

## Response `200`

Success

- CallSessionObject: Call session information
  - `id` string: Internal identifier of a call session
  - `origin` OriginInfo: Session origin details
    - `type` 'Call' | 'RingOut' | 'RingMe' | 'Conference' | 'GreetingsRecording' | 'VerificationCall' | 'Zoom' | 'CallOut': Session origin type
  - `voiceCallToken` string: For calls of 'Conference' type only
  - `parties` CallParty[]
    - `id` string: Internal identifier of a party
    - `status` CallStatusInfo: Status data of a call session
      - `code` 'Setup' | 'Proceeding' | 'Answered' | 'Disconnected' | 'Gone' | 'Parked' | 'Hold' | 'VoiceMail' | 'FaxReceive' | 'Tds' | 'VoiceMailScreening': Status code of a call
      - `peerId` PeerInfo: Peer session/party details. Valid in 'Gone' state of a call
        - `sessionId` string
        - `telephonySessionId` string
        - `partyId` string
      - `reason` 'Pickup' | 'Supervising' | 'TakeOver' | 'Timeout' | 'BlindTransfer' | 'RccTransfer' | 'AttendedTransfer' | 'CallerInputRedirect' | 'CallFlip' | 'ParkLocation' | 'DtmfTransfer' | 'AgentAnswered' | 'AgentDropped' | 'Rejected' | 'Cancelled' | 'InternalError' | 'NoAnswer' | 'TargetBusy' | 'InvalidNumber' | 'InternationalDisabled' | 'DestinationBlocked' | 'NotEnoughFunds' | 'NoSuchUser' | 'CallPark' | 'CallRedirected' | 'CallReplied' | 'CallSwitch' | 'CallFinished' | 'CallDropped': Reason for call termination. For 'Disconnected' code only
      - `description` string: Optional message
    - `muted` boolean: Specifies if a call participant is muted or not. **Note:** If a call is also controlled via Hard phone or RingCentral App (not only through the API by calling call control methods) then it cannot be fully muted/unmuted via API only, in this case the action should be duplicated via Hard phone/RC App interfaces
    - `standAlone` boolean: If `true` then the party is not connected to a session voice conference, `false` means the party is connected to other parties in a session
    - `park` ParkInfo: Call park information
      - `id` string: Call park identifier
    - `from` PartyInfo
      - `phoneNumber` string: Phone number of a party
      - `name` string: Displayed name of a party
      - `deviceId` string: Internal identifier of a device
      - `extensionId` string: Internal identifier of an extension
    - `to` PartyInfo
      - `phoneNumber` string: Phone number of a party
      - `name` string: Displayed name of a party
      - `deviceId` string: Internal identifier of a device
      - `extensionId` string: Internal identifier of an extension
    - `owner` OwnerInfo: Deprecated. Information on a call owner
      - `accountId` string: Internal identifier of an account that monitors a call
      - `extensionId` string: Internal identifier of an extension that monitors a call
    - `direction` 'Inbound' | 'Outbound': Direction of a call
    - `conferenceRole` 'Host' | 'Participant': A party's role in the conference scenarios. For calls of 'Conference' type only
    - `ringOutRole` 'Initiator' | 'Target': A party's role in 'Ring Me'/'RingOut' scenarios. For calls of 'Ringout' type only
    - `ringMeRole` 'Initiator' | 'Target': A party's role in 'Ring Me'/'RingOut' scenarios. For calls of 'Ringme' type only
    - `recordings` RecordingInfo[]: Active recordings list
      - `id` string: Internal identifier of a recording resource
      - `active` boolean: True if the recording is active. False if the recording is paused.
  - `creationTime` string, date-time: Date and time of the latest session update represented in Unix time format

## Other responses

- `403`: General response with **HTTP 403 "Forbidden"** status.<br> Reasons: the requested operation is forbidden because of certain resource state, lack of permissions, feature unavailability, etc.
- `404`: General response with **HTTP 404 "Not found"** status.<br> Reasons: the entity with given ID (typically specified in a path parameter), is not found or inaccessible
- `500`: General response with **HTTP 500 "Internal Server Error"** status.<br> Reasons: general server-side error.
- `503`: General response with **HTTP 503 "Service not available"** status.<br> Reasons: server cannot process the request because of being overloaded, misconfiguration or other issues.

---

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