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

# Make RingOut Call

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

Makes a 2-legged RingOut call.

## Path parameters

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

## Request body

- MakeRingOutRequest
  - `from` MakeRingOutCallerInfoRequestFrom, required — Phone number of a caller. This number corresponds to the 1st leg of a RingOut call. This number can be one of the user's configured forwarding numbers or an arbitrary number
    - `phoneNumber` string — Phone number in E.164 format
    - `forwardingNumberId` string — Internal identifier of a forwarding number; returned in response as an 'id' field value. Can be specified instead of a `phoneNumber` attribute
  - `to` MakeRingOutCallerInfoRequestTo, required — Phone number of a called party. This number corresponds to the 2nd leg of a RingOut call
    - `phoneNumber` string — Phone number in E.164 format
  - `callerId` MakeRingOutCallerIdInfo — Phone number which will be displayed to the called party
    - `phoneNumber` string — Phone number in E.164 format
  - `playPrompt` boolean — Audio prompt that a calling party hears when a call is connected
  - `country` MakeRingOutCountryInfo — Optional. Dialing plan country data. If not specified, then an extension home country is applied by default
    - `id` string — Dialing plan country identifier

## Response `200`

Ring out call 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.net/ringcentral/apis/ringcentral-api.md) · [All operations](https://skmtc.net/ringcentral/apis/ringcentral-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ringcentral/ringcentral-api/revisions/8d602198ec97/schema)