Idea

John Wang avatar image
John Wang Posted ·

How to retrieve a list of direct numbers for an extension

RingCentral direct numbers are phone numbers that can be assigned to user extensions. An extension can have multiple direct numbers assigned and calling a direct number will initiate the extension's call handling rules.

To retrieve a list of direct numbers for an extension, make an API call to the extension's "phone-number" endpoint as follows and filter on numbers with "usageType" set to "DirectNumber":

Request example

GET /restapi/v1.0/account/11111111/extension/22222222/phone-number HTTP/1.1
Authorization: Bearer MyAccessToken
Response example

{    "uri" => "https://platform.ringcentral.com/restapi/v1.0/account/11111111/extension/22222222/phone-number?page=1&perPage=100"
"records"=> [ { "id" => 33333333, "phoneNumber" => "+16505551212", "paymentType" => "Local", "type" => "VoiceFax", "usageType" => "DirectNumber", "features" => ["SmsSender", "CallerId"], "status" => "Normal", "country" => { "uri" => "https://platform.devtest.ringcentral.com/restapi/v1.0/dictionary/country/1", "id" => "1", "name" => "United States" } } ] }

Each direct number record will have a "usageType" attribute set to "DirectNumber". The phone number itself is set to the "phoneNumber" property in E.164 format.
topic-default
1 |1000 characters needed characters left characters exceeded

Up to 8 attachments (including images) can be used with a maximum of 1.0 MiB each and 10.0 MiB total.

No Comments

· Write a Comment

Write a Comment

Up to 8 attachments (including images) can be used with a maximum of 1.0 MiB each and 10.0 MiB total.

Your Opinion Counts

Share your great idea, or help out by voting for other people's ideas.