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

# GET /deviceUpdate/{instanceId}/management/deviceDiagnostics/deviceHealth

`GET /deviceUpdate/{instanceId}/management/deviceDiagnostics/deviceHealth`

Get list of device health

## Path parameters

- `instanceId` string, required

## Query parameters

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

## Response `200`

The request has succeeded.

- DeviceHealthList — Array of Device Health, with server paging support.
  - `value` DeviceHealth[], required — The DeviceHealth items on this page
    - `deviceId` string, required — Device id
    - `moduleId` string — Module id
    - `state` 'healthy' | 'unhealthy', required — Device health states
    - `digitalTwinModelId` string — Digital twin model Id
    - `healthChecks` HealthCheck[], required — Array of health checks and their results
      - `name` string — Health check name
      - `result` 'success' | 'userError' — Health check result
  - `nextLink` string, uri — The link to the next page of items

## Other responses

- `default` — An unexpected error response.

## Changes

> 6 revisions in range; 1 could not be searched.

- **2026-07-13** (2020-09-01) `5ba53cf1b884` — 1 info
  - endpoint added
- **2026-07-13** (2020-09-01) `6f894985f81d` — 1 info
  - api operation id `DeviceManagement_ListDeviceHealth` removed and replaced with `DeviceManagement_ListHealthOfDevices`
- **2021-03-02** (2020-09-01) `be0eed01a5b1` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/azure/apis/deviceupdate-microsoft-deviceupdate/changes/deviceUpdate/:instanceId/management/deviceDiagnostics/deviceHealth/get.md)

---

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