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

# List Account Switches

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

Returns a corporate map of configured network switches with the assigned
emergency addresses for the logged-in account.

## Path parameters

- `accountId` string, required

## Query parameters

- `siteId` string[]
- `searchString` string
- `orderBy` string
- `perPage` integer
- `page` integer

## Response `200`

Switches Map

- SwitchesList
  - `records` SwitchInfo[] — Switches map
    - `uri` string, uri — Link to the network switch resource
    - `id` string — Internal identifier of a network switch
    - `chassisId` string — Unique identifier of a network switch
    - `port` string — Switch entity extension for better diversity. Should be used together with chassisId.
    - `name` string — Name of a network switch
    - `site` SwitchSiteInfo
      - `id` string — Internal identifier of a site. The company identifier value is 'main-site'
      - `name` string — Name of a site
    - `emergencyAddress` union
      - object
        - `country` string — Country name
        - `countryId` string — Internal identifier of a country
        - `countryIsoCode` string — ISO code of a country
        - `countryName` string — Full name of a country
        - `state` string — State/Province name. Mandatory for the USA, the UK and Canada
        - `stateId` string — Internal identifier of a state
        - `stateIsoCode` string — ISO code of a state
        - `stateName` string — Full name of a state
        - `city` string — City name
        - `street` string — First line address
        - `street2` string — Second line address (apartment, suite, unit, building, floor, etc.)
        - `zip` string — Postal (Zip) code
        - `customerName` string — Customer name
        - `syncStatus` 'Verified' | 'Updated' | 'Deleted' | 'NotRequired' | 'Unsupported' | 'Failed' — Resulting status of emergency address synchronization. Returned for 'Get Device Info' request if `syncEmergencyAddress` parameter is set to `true`
      - object
        - `country` string — Country name
        - `countryId` string — Internal identifier of a country
        - `countryIsoCode` string — ISO code of a country
        - `countryName` string — Full name of a country
        - `state` string — State/Province name. Mandatory for the USA, the UK and Canada
        - `stateId` string — Internal identifier of a state
        - `stateIsoCode` string — ISO code of a state
        - `stateName` string — Full name of a state
        - `city` string — City name
        - `street` string — The name of the street (the field is utilized as 'streetName' field for AU addresses)
        - `companyName` string — Company name
        - `buildingName` string — (Optional) Building name
        - `streetType` string — Street type
        - `buildingNumber` string — Building/street number
        - `street2` string — Second line address (apartment, suite, unit, building, floor, etc.)
        - `zip` string — Postal (Zip) code
        - `customerName` string — Customer name
        - `syncStatus` 'Verified' | 'Updated' | 'Deleted' | 'NotRequired' | 'Unsupported' | 'Failed' — Resulting status of emergency address synchronization. Returned for 'Get Device Info' request if `syncEmergencyAddress` parameter is set to `true`
      - object
        - `country` string — Country name
        - `countryId` string — Internal identifier of a country
        - `countryIsoCode` string — ISO code of a country
        - `countryName` string — Full name of a country
        - `state` string — State/Province name. Mandatory for the USA, the UK and Canada
        - `stateId` string — Internal identifier of a state
        - `stateIsoCode` string — ISO code of a state
        - `stateName` string — Full name of a state
        - `city` string — City name
        - `street` string — The name of the street (The field is utilized as 'streetName' field for FR addresses)
        - `companyName` string — Company name
        - `buildingName` string — (Optional) Building name
        - `buildingNumber` string — Building/street number
        - `street2` string — Second line address (apartment, suite, unit, building, floor, etc.)
        - `zip` string — Postal (Zip) code
        - `customerName` string — Customer name
        - `syncStatus` 'Verified' | 'Updated' | 'Deleted' | 'NotRequired' | 'Unsupported' | 'Failed' — Resulting status of emergency address synchronization. Returned for 'Get Device Info' request if `syncEmergencyAddress` parameter is set to `true`
    - `emergencyLocation` EmergencyLocationInfo — Emergency response location information
      - `id` string, required — Internal identifier of an emergency response location
      - `name` string — Emergency response location name
      - `addressFormatId` string — Address format ID
  - `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.net/ringcentral/apis/ringcentral-api.md) · [All operations](https://skmtc.net/ringcentral/apis/ringcentral-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ringcentral/ringcentral-api/revisions/8d602198ec97/schema)