How to retrieve a list of direct numbers for an extension

  • 1
  • Idea
  • Updated 2 years ago
  • (Edited)
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" => ""
"records"=> [ { "id" => 33333333, "phoneNumber" => "+16505551212", "paymentType" => "Local", "type" => "VoiceFax", "usageType" => "DirectNumber", "features" => ["SmsSender", "CallerId"], "status" => "Normal", "country" => { "uri" => "", "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.
Photo of John Wang

John Wang, Official Rep

  • 4,522 Points 4k badge 2x thumb

Posted 2 years ago

  • 1

Be the first to post a reply!