---
title: "List Devices"
method: GET
path: "/restapi/v1.0/account/{accountId}/emergency-address-auto-update/devices"
tags: ["Automatic Location Updates"]
---

# List Devices

`GET /restapi/v1.0/account/{accountId}/emergency-address-auto-update/devices`

## Request

- Base URL: `https://platform.ringcentral.com`
- URL: `https://platform.ringcentral.com/restapi/v1.0/account/{accountId}/emergency-address-auto-update/devices`
- Auth: OAuth 2
  - Authorization code: `https://platform.ringcentral.com/restapi/oauth/authorize`
  - Token URL: `https://platform.ringcentral.com/restapi/oauth/token`
- TypeScript: <https://skmtc.dev/ringcentral/apis/ringcentral-api/docs/restapi/v1.0/account/:accountId/emergency-address-auto-update/devices/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns a list of common devices with their status of Automatic
Location Updates feature.

## Path parameters

- `accountId` string, required

## Query parameters

- `siteId` string[]
- `featureEnabled` boolean
- `modelId` string
- `compatibleOnly` boolean
- `searchString` string
- `orderBy` string
- `perPage` integer
- `page` integer

## Response `200`

Device list with their status of Automatic Location Updates feature

- ListDevicesAutomaticLocationUpdates
  - `uri` string, uri: Link to a devices resource
  - `records` AutomaticLocationUpdatesDeviceInfo[]: List of the user(s) devices with the current status of Emergency Address Auto Update Feature
    - `id` string: Internal identifier of a device
    - `type` 'HardPhone' | 'SoftPhone' | 'OtherPhone': Device type
    - `serial` string: Serial number for HardPhone (is returned only when the phone is shipped and provisioned)
    - `featureEnabled` boolean: Specifies if Automatic Location Updates feature is enabled
    - `name` string: Device name
    - `model` AutomaticLocationUpdatesModelInfo: HardPhone model information
      - `id` string: Device model identifier
      - `name` string: Device name
      - `features` AutomaticLocationUpdatesModelFeature[]: Device feature or multiple features supported
    - `site` AutomaticLocationUpdatesSiteInfo: Site data. If multi-site feature is turned on for the account, then ID of a site must be specified. In order to assign a wireless point to the main site (company) site ID should be set to `main-site`
      - `id` string: Internal identifier of a site
      - `uri` string, uri: Link to a site resource
      - `name` string: Name of a site
      - `code` string: Site code value. Returned only if specified
    - `phoneLines` AutomaticLocationUpdatesPhoneLine[]: Phone lines information
      - `lineType` 'Unknown' | 'Standalone' | 'StandaloneFree' | 'BlaPrimary' | 'BlaSecondary' | 'BLF'
      - `phoneInfo` AutomaticLocationUpdatesPhoneNumberInfo
        - `id` integer: Internal identifier of a phone number
        - `phoneNumber` string: Phone number
  - `navigation` PageNavigationModel: Links to other pages of the current result set
    - `firstPage` PageNavigationUri
      - `uri` string, uri: Canonical URI to retrieve the particular page of the result set
    - `nextPage` PageNavigationUri
      - `uri` string, uri: Canonical URI to retrieve the particular page of the result set
    - `previousPage` PageNavigationUri
      - `uri` string, uri: Canonical URI to retrieve the particular page of the result set
    - `lastPage` PageNavigationUri
      - `uri` string, uri: Canonical URI to retrieve the particular page of the result set
  - `paging` EnumeratedPagingModel
    - `perPage` integer, required: Current page size, describes how many items are in each page. Matches "perPage" parameter from the request.
    - `page` integer: The current page number. 1-indexed, so the first page is 1 by default. May be omitted if result is empty (because non-existent page was specified or perPage=0 was requested)
    - `pageStart` integer: The zero-based number of the first element on the current page. Omitted if the page is omitted or result is empty
    - `pageEnd` integer: The zero-based index of the last element on the current page. Omitted if the page is omitted or result is empty
    - `totalPages` integer: The total number of pages in a dataset. May be omitted for some resources due to performance reasons
    - `totalElements` integer: The total number of elements in a dataset. May be omitted for some resource due to performance reasons

---

[API](https://skmtc.dev/ringcentral/apis/ringcentral-api.md) - [All operations](https://skmtc.dev/ringcentral/apis/ringcentral-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ringcentral/apis/ringcentral-api/revisions/8d602198ec97?raw)