---
title: "Get the devices of a device group"
method: GET
path: "/deviceGroups/{deviceGroupId}/devices"
---

# Get the devices of a device group

`GET /deviceGroups/{deviceGroupId}/devices`

Get the list of devices by device group ID.

## Path parameters

- `deviceGroupId` string, required

## Query parameters

- `api-version` string, required
- `maxpagesize` integer

## Response `200`

Success

- DeviceGroupDeviceCollection — The paged results of devices belonging to the device group.
  - `value` Device[], required — The collection of devices belonging to the device group.
    - `id` string — Unique ID of the device.
    - `etag` string — ETag used to prevent conflict in device updates.
    - `displayName` string — Display name of the device.
    - `template` string — The device template definition for the device.
    - `enabled` boolean — Whether the device connection to IoT Central has been enabled.
    - `provisioned` boolean — Whether resources have been allocated for the device.
    - `simulated` boolean — Whether the device is simulated.
    - `organizations` string[] — List of organization IDs that the device is a part of, only one organization is supported today, multiple organizations will be supported soon.
    - `type` string[] — The type of the device.
    - `deploymentManifest` DeploymentManifest — The deployment manifest used for edge devices.
      - `id` string — Unique ID of the deployment manifest.
      - `displayName` string — Display name of the deployment manifest.
      - `data` object, required — Content of the the deployment manifest.
      - `etag` string — Etag to prevent conflict when updating the deployment manifest.
      - `organizations` string[] — The organization that deployment manifest belongs to. If not present, the deployment manifest is root-level or personal. Only one organization is supported today, multiple organizations will be supported soon.
  - `nextLink` string — URL to get the next page of devices in the group.

## Other responses

- `default` — An error response received from the IoT Central Service.

---

[API](https://skmtc.net/azure/apis/iotcentral-iotcentral.md) · [All operations](https://skmtc.net/azure/apis/iotcentral-iotcentral/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/iotcentral-iotcentral/versions/565d8813cbd3/schema)