---
title: "GET /deviceUpdate/{instanceId}/management/devices"
method: GET
path: "/deviceUpdate/{instanceId}/management/devices"
tags: ["Device and deployment management"]
---

# GET /deviceUpdate/{instanceId}/management/devices

`GET /deviceUpdate/{instanceId}/management/devices`

Gets a list of devices connected to Device Update for IoT Hub.

## Path parameters

- `instanceId` string, required

## Query parameters

- `api-version` string, required
- `filter` string

## Response `200`

The request has succeeded.

- DevicesList — The list of devices.
  - `value` Device[], required — The Device items on this page
    - `deviceId` string, required — Device identity.
    - `moduleId` string — Device module identity.
    - `deviceClassId` string, required — Device class identity.
    - `groupId` string — Device group identity.
    - `lastAttemptedUpdate` UpdateInfo — Update information.
      - `updateId` UpdateId, required — Update identifier.
        - `provider` string, required — Update provider.
        - `name` string, required — Update name.
        - `version` string, required — Update version.
      - `description` string — Update description.
      - `friendlyName` string — Friendly update name.
    - `deploymentStatus` 'Succeeded' | 'InProgress' | 'Canceled' | 'Failed' — Deployment state.
    - `installedUpdate` UpdateInfo — Update information.
      - `updateId` UpdateId, required — Update identifier.
        - `provider` string, required — Update provider.
        - `name` string, required — Update name.
        - `version` string, required — Update version.
      - `description` string — Update description.
      - `friendlyName` string — Friendly update name.
    - `onLatestUpdate` boolean, required — Boolean flag indicating whether the latest update (the best compatible update for the device's device class and group) is installed on the device
    - `lastDeploymentId` string — The deployment identifier for the last deployment to the device
    - `lastInstallResult` InstallResult — The install result of an update and any step results under it.
      - `resultCode` integer, required — Install result code.
      - `extendedResultCode` integer, required — Install extended result code
      - `resultDetails` string — A string containing further details about the install result
      - `stepResults` StepResult[] — Array of step results
        - `update` UpdateInfo — Update information.
          - `updateId` UpdateId, required — Update identifier.
            - `provider` string, required — Update provider.
            - `name` string, required — Update name.
            - `version` string, required — Update version.
          - `description` string — Update description.
          - `friendlyName` string — Friendly update name.
        - `description` string — Step description.
        - `resultCode` integer, required — Install result code.
        - `extendedResultCode` integer, required — Install extended result code
        - `resultDetails` string — A string containing further details about the install result
  - `nextLink` string, uri — The link to the next page of items

## Other responses

- `default` — An unexpected error response.

---

[API](https://skmtc.net/azure/apis/deviceupdate-microsoft-deviceupdate.md) · [All operations](https://skmtc.net/azure/apis/deviceupdate-microsoft-deviceupdate/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/deviceupdate-microsoft-deviceupdate/revisions/ceb0ecac6c82/schema)