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

# GET /deviceUpdate/{instanceId}/management/groups/{groupId}

`GET /deviceUpdate/{instanceId}/management/groups/{groupId}`

Gets the device group properties.

## Path parameters

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

## Query parameters

- `api-version` string, required

## Response `200`

The request has succeeded.

- Group — Group details.
  - `groupId` string, required — Group identity. This is created from the value of the ADUGroup tag in the Iot Hub's device/module twin or $default for devices with no tag.
  - `groupType` 'IoTHubTag' | 'DefaultNoTag', required — Supported group types.
  - `createdDateTime` string, required — Date and time when the update was created.
  - `deviceCount` integer — The number of devices in the group.
  - `subgroupsWithNewUpdatesAvailableCount` integer — The count of subgroups with new updates available.
  - `subgroupsWithUpdatesInProgressCount` integer — The count of subgroups with updates in progress.
  - `subgroupsWithOnLatestUpdateCount` integer — The count of subgroups with devices on the latest update.
  - `deployments` string[] — The active deployment Ids for the group

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