---
title: "Get RingOut Call Status"
method: GET
path: "/restapi/v1.0/account/{accountId}/extension/{extensionId}/ring-out/{ringoutId}"
tags: ["RingOut"]
---

# Get RingOut Call Status

`GET /restapi/v1.0/account/{accountId}/extension/{extensionId}/ring-out/{ringoutId}`

## Request

- Base URL: `https://platform.ringcentral.com`
- URL: `https://platform.ringcentral.com/restapi/v1.0/account/{accountId}/extension/{extensionId}/ring-out/{ringoutId}`
- 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/extension/:extensionId/ring-out/:ringoutId/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns a status of a 2-legged RingOut call.

## Path parameters

- `accountId` string, required
- `extensionId` string, required
- `ringoutId` string, required

## Response `200`

RingOut call status information

- GetRingOutStatusResponse
  - `id` string: Internal identifier of a RingOut call
  - `uri` string, uri: Link to a RingOut call resource
  - `status` RingOutStatusInfo: RingOut status information
    - `callStatus` 'Invalid' | 'Success' | 'InProgress' | 'Busy' | 'NoAnswer' | 'Rejected' | 'GenericError' | 'Finished' | 'InternationalDisabled' | 'DestinationBlocked' | 'NotEnoughFunds' | 'NoSuchUser': Status of a call
    - `callerStatus` 'Invalid' | 'Success' | 'InProgress' | 'Busy' | 'NoAnswer' | 'Rejected' | 'GenericError' | 'Finished' | 'InternationalDisabled' | 'DestinationBlocked' | 'NotEnoughFunds' | 'NoSuchUser': Status of a calling party
    - `calleeStatus` 'Invalid' | 'Success' | 'InProgress' | 'Busy' | 'NoAnswer' | 'Rejected' | 'GenericError' | 'Finished' | 'InternationalDisabled' | 'DestinationBlocked' | 'NotEnoughFunds' | 'NoSuchUser': Status of a called party

---

[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)