---
title: "Gets the device list."
method: GET
path: "/api/devices"
tags: ["IoT Devices"]
---

# Gets the device list.

`GET /api/devices`

## Query parameters

- `searchText` string
- `searchStatus` boolean
- `searchState` boolean
- `pageSize` integer
- `pageNumber` integer
- `orderBy` string[]
- `modelId` string
- `labels` string[]

## Response `200`

Success

- DeviceListItemPaginationResult — Class representing the page results.
  - `items` DeviceListItem[], nullable — The current page items.
    - `deviceID` string, nullable — The device Identifier.
    - `deviceName` string, nullable — The device friendly name.
    - `deviceModelId` string, nullable — The device Model Identifier.
    - `imageUrl` string, uri, nullable — The device model image Url.
    - `isConnected` boolean — A value indicating whether the device is currently connected.
    - `isEnabled` boolean — A value indicating whether the device is enabled on the platform.
    - `supportLoRaFeatures` boolean — A value indicating whether the LoRa features is supported on this model.
    - `hasLoRaTelemetry` boolean — A value indicating whether the device has telemetry.
    - `statusUpdatedTime` string, date-time — The device last status updated time.
    - `labels` LabelDto[], nullable — The device labels.
      - `name` string, required
      - `color` string, required
  - `totalItems` integer — The total number of items.
  - `nextPage` string, nullable — The query next page Url.

---

[API](https://skmtc.net/cgi-fr/apis/azure-iot-hub-portal-api.md) · [All operations](https://skmtc.net/cgi-fr/apis/azure-iot-hub-portal-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cgi-fr/azure-iot-hub-portal-api/versions/ce058568b9f0/schema)