Sign in

v1

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

List Extensions

Returns the list of extensions created for a particular account. All types of extensions are included in this list.

get/restapi/v1.0/account/{accountId}/extension

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)

Query parameters

extensionNumberstring

Extension short number to filter records

emailstring

Extension email address. Multiple values are accepted

pageinteger

Indicates a page number to retrieve. Only positive number values are allowed

perPageinteger

Indicates a page size (number of items)

statusstring[]

Extension current state. Multiple values are supported. If 'Unassigned' is specified, then extensions without extensionNumber attribute are returned. If not specified, then all extensions are returned

typestring[]

Extension type. Multiple values are supported. Please note that legacy 'Department' extension type corresponds to 'Call Queue' extensions in modern RingCentral product terminology

Response

Extension list information

uristring uri

Link to an extension list resource

Example response

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