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

# Gets the IoT Edge device list.

`GET /api/edge/devices`

## Query parameters

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

## Response `200`

OK

- IoTEdgeListItemPaginationResult — Class representing the page results.
  - `items` IoTEdgeListItem[], nullable — The current page items.
    - `deviceId` string, required — The device identifier.
    - `deviceName` string, nullable — The device status.
    - `status` string, nullable — The device status.
    - `nbDevices` integer — The number of devices connected on the IoT Edge.
    - `image` string, nullable — The device model image Url.
    - `labels` LabelDto[], nullable — Gets the edge device labels.
      - `name` string, required
      - `color` string, required
  - `totalItems` integer — The total number of items.
  - `nextPage` string, nullable — The query next page Url.

## Changes

- **2026-08-20** `8f5ec4f45de1` — 3 warning, 3 info
  - removed the optional property `items/items/imageUrl` from the response with the `200` status (media type: text/plain)
  - removed the optional property `items/items/imageUrl` from the response with the `200` status (media type: application/json)
  - removed the optional property `items/items/imageUrl` from the response with the `200` status (media type: text/json)
  - added the optional property `items/items/image` to the response with the `200` status (media type: text/plain)
  - …2 more

[Change history](https://skmtc.dev/cgi-fr/apis/azure-iot-hub-portal-api/changes/api/edge/devices/get.md)

---

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