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

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

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

Gets a list of deployments.

## Path parameters

- `instanceId` string, required

## Query parameters

- `$filter` string

## Response `200`

The deployments.

- PageableListOfDeployments — The list of deployments.
  - `value` Deployment[] — The collection of pageable items.
    - `deploymentId` string, required — Gets or sets the deployment identifier.
    - `deploymentType` 'Complete' | 'Download' | 'Install', required — Supported deployment types.
    - `deviceClassId` string — Gets or sets the device class identifier.
    - `startDateTime` string, date-time, required — Gets or sets the Deployment start datetime.
    - `deviceGroupType` 'All' | 'Devices' | 'DeviceGroupDefinitions', required — Supported deployment group types.
    - `deviceGroupDefinition` string[], required — Gets or sets the device group definition.
    - `updateId` UpdateId, required — Update identifier.
      - `provider` string, required — Update provider.
      - `name` string, required — Update name.
      - `version` string, required — Update version.
    - `isCanceled` boolean — Boolean flag indicating whether the deployment was canceled.
    - `isRetried` boolean — Boolean flag indicating whether the deployment has been retried.
    - `isCompleted` boolean — Boolean flag indicating whether the deployment was completed.
  - `nextLink` string — The link to the next page of items.

## 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/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)