---
title: "GET /deviceupdate/{instanceId}/v2/management/deployments/{deploymentId}/devicestates"
method: GET
path: "/deviceupdate/{instanceId}/v2/management/deployments/{deploymentId}/devicestates"
tags: ["Deployment management"]
---

# GET /deviceupdate/{instanceId}/v2/management/deployments/{deploymentId}/devicestates

`GET /deviceupdate/{instanceId}/v2/management/deployments/{deploymentId}/devicestates`

Gets a list of devices in a deployment along with their state. Useful for getting a list of failed devices.

## Path parameters

- `instanceId` string, required
- `deploymentId` string, required

## Query parameters

- `$filter` string

## Response `200`

The devices in the deployment along with their states.

- PageableListOfDeploymentDeviceStates — The list of deployment device states.
  - `value` DeploymentDeviceState[] — The collection of pageable items.
    - `deviceId` string, required — Device identity.
    - `retryCount` integer, required — The number of times this deployment has been retried on this device.
    - `movedOnToNewDeployment` boolean, required — Boolean flag indicating whether this device is in a newer deployment and can no longer retry this deployment.
    - `deviceState` 'Succeeded' | 'InProgress' | 'Failed' | 'Canceled' | 'Incompatible', required — Deployment state.
  - `nextLink` string — The link to the next page of items.

## Other responses

- `404` — Not found.

## Changes

- **2021-03-02** (2020-09-01) `be0eed01a5b1` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/azure/apis/deviceupdate-microsoft-deviceupdate/changes/deviceupdate/:instanceId/v2/management/deployments/:deploymentId/devicestates/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/be0eed01a5b1/schema)