Sign in

v1

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

List Extension Devices

Returns devices of an extension or multiple extensions by their ID(s). Batch request is supported.

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

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

pageinteger

The result set page number (1-indexed) to return

perPageinteger

The number of items per page. If provided value in the request is greater than a maximum, the maximum value is applied

linePooling'Host' | 'Guest' | 'None'

Pooling type of device - Host - a device with standalone paid phone line which can be linked to a soft client instance - Guest - a device with a linked phone line - None - a device without a phone line or with specific line (free, BLA, etc.)

feature'BLA' | 'CommonPhone' | 'Intercom' | 'Paging' | 'HELD'

Device feature

Device feature or multiple features supported

type'HardPhone' | 'SoftPhone' | 'OtherPhone' | 'MobileDevice' | 'BLA' | 'Paging' | 'WebPhone' | 'WebRTC' | 'Room'

Device type

lineType'Unknown' | 'Standalone' | 'StandaloneFree' | 'BlaPrimary' | 'BlaSecondary'

The type of phone line

Phone line type

Response

Extension devices information

uristring uri

Link to a list of extension devices

Example response

{
  "records": [
    {
      "shipping": {
        "status": "Shipped"
      }
    }
  ],
  "paging": {
    "perPage": 50,
    "page": 5,
    "pageEnd": 5,
    "totalPages": 25,
    "totalElements": 25
  }
}