v1

latestOpenAPI 3.0.3RingCentral API License Agreement2026-08-064871,2921.5 MB
Phone Numbers

Get Extension Phone Number List

Returns the list of phone numbers that are used by a particular extension, can be filtered by the phone number type. The returned list contains all numbers which are directly mapped to the given extension. Plus the features and company-level numbers that may be used when performing different operations on behalf of this extension.

get/restapi/v1.0/account/{accountId}/extension/{extensionId}/phone-number

Path parameters

accountIdstring required

Internal identifier of the RingCentral account (can be set to "~" to indicate that the account associated with current authorization session should be used)

extensionIdstring required

Internal identifier of the RingCentral extension/user (can be set to "~" to indicate that the extension associated with current authorization session should be used)

Query parameters

status'Normal' | 'Pending' | 'PortedIn' | 'Temporary'

Status of a phone number

usageTypestring[]

Usage type of phone number

pageinteger

Indicates a page number to retrieve. Only positive number values are allowed. Default value is '1'

perPageinteger

Indicates a page size (number of items). If not specified, the value is '100' by default

Response

OK: User Phone Number List

uristring uri

Link to the user phone number list resource

Example response

{
  "paging": {
    "perPage": 50,
    "page": 5,
    "pageEnd": 5,
    "totalPages": 25,
    "totalElements": 25
  }
}