---
title: "[LRO] List devices"
method: GET
path: "/devices"
tags: ["Device"]
---

# [LRO] List devices

`GET /devices`

List devices with filters and pagination.

## Query parameters

- `page` integer
- `limit` integer
- `locationId` integer
- `connected` boolean
- `adminStates` XiqDeviceAdminState[]
- `macAddresses` string[]
- `sns` string[]
- `hostnames` string[]
- `sortField` 'MAC' | 'SN' — All available device sort fields<br/><br/>MAC = Device MAC Address<br/>SN = Device Serial Number
- `order` 'ASC' | 'DESC' — Sort Order
- `views` XiqDeviceView[]
- `fields` XiqDeviceField[]
- `deviceTypes` XiqDeviceType[]
- `nullField` 'LOCATION_ID' | 'NETWORK_POLICY_ID'
- `locationIds` integer[]
- `async` boolean
- `configMismatch` boolean

## Response `200`

OK

- PagedXiqDevice
  - `page` integer, required — The current page number
  - `count` integer, required — The element count of the current page
  - `total_pages` integer, required — The total page number based on request page size
  - `total_count` integer, required — The total element count
  - `data` XiqDevice[] — The data in the current page
    - `id` integer — The Device Id
    - `hostname` string — The Device Hostname

---

[API](https://skmtc.net/extremecloudiq/apis/extremecloud-iq-api.md) · [All operations](https://skmtc.net/extremecloudiq/apis/extremecloud-iq-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/extremecloudiq/extremecloud-iq-api/versions/5ff7ab84e8e8/schema)