---
title: "GET /deviceUpdate/{instanceId}/management/groups/{groupId}/deployments/{deploymentId}/status"
method: GET
path: "/deviceUpdate/{instanceId}/management/groups/{groupId}/deployments/{deploymentId}/status"
tags: ["Device and deployment management"]
---

# GET /deviceUpdate/{instanceId}/management/groups/{groupId}/deployments/{deploymentId}/status

`GET /deviceUpdate/{instanceId}/management/groups/{groupId}/deployments/{deploymentId}/status`

Gets the status of a deployment including a breakdown of how many devices in
the deployment are in progress, completed, or failed.

## Path parameters

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

## Query parameters

- `api-version` string, required

## Response `200`

The request has succeeded.

- DeploymentStatus — Deployment status metadata.
  - `groupId` string, required — The group identity
  - `deploymentState` 'Active' | 'ActiveWithSubgroupFailures' | 'Failed' | 'Inactive' | 'Canceled', required — Deployment state.
  - `error` Error — Error details.
    - `code` string, required — Server defined error code.
    - `message` string, required — A human-readable representation of the error.
    - `target` string — The target of the error.
    - `details` Error[] — An array of errors that led to the reported error.
    - `innererror` InnerError — An object containing more specific information than the current object about the error.
      - `code` string, required — A more specific error code than what was provided by the containing error.
      - `message` string — A human-readable representation of the error.
      - `errorDetail` string — The internal error or exception message.
      - `innerError` InnerError — recursive
    - `occurredDateTime` string, date-time — Date and time in UTC when the error occurred.
  - `subgroupStatus` DeviceClassSubgroupDeploymentStatus[], required — The collection of device class subgroup status objects
    - `groupId` string, required — The group identity
    - `deviceClassId` string, required — The device class subgroup identity
    - `deploymentState` 'Active' | 'Failed' | 'Inactive' | 'Canceled', required — Device class subgroup deployment state.
    - `error` Error — Error details.
      - `code` string, required — Server defined error code.
      - `message` string, required — A human-readable representation of the error.
      - `target` string — The target of the error.
      - `details` Error[] — An array of errors that led to the reported error.
      - `innererror` InnerError — An object containing more specific information than the current object about the error.
        - `code` string, required — A more specific error code than what was provided by the containing error.
        - `message` string — A human-readable representation of the error.
        - `errorDetail` string — The internal error or exception message.
        - `innerError` InnerError — recursive
      - `occurredDateTime` string, date-time — Date and time in UTC when the error occurred.
    - `totalDevices` integer — The total number of devices in the deployment.
    - `devicesInProgressCount` integer — The number of devices that are currently in deployment.
    - `devicesCompletedFailedCount` integer — The number of devices that have completed deployment with a failure.
    - `devicesCompletedSucceededCount` integer — The number of devices which have successfully completed deployment.
    - `devicesCanceledCount` integer — The number of devices which have had their deployment canceled.

## Other responses

- `default` — An unexpected error response.

## Changes

- **2026-07-13** (2020-09-01) `5ba53cf1b884` — 1 info
  - endpoint added
- **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/groups/:groupId/deployments/:deploymentId/status/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)