---
title: "Get the list of device groups in an application."
method: GET
path: "/deviceGroups"
---

# Get the list of device groups in an application.

`GET /deviceGroups`

## Query parameters

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

## Response `200`

Success

- DeviceGroupCollection — The paged results of device groups.
  - `value` DeviceGroup[], required — The collection of device groups.
    - `id` string — Unique ID of the device group.
    - `displayName` string, required — Display name of the device group.
    - `filter` string, required — Query defining which devices should be in this group, [Query Language Reference](https://aka.ms/iotcquery).
    - `description` string — Short summary of device group.
    - `etag` string — ETag used to prevent conflict in device group updates.
    - `organizations` string[] — List of organization IDs of the device group, only one organization is supported today, multiple organizations will be supported soon.
  - `nextLink` string — URL to get the next page of device groups.

## Other responses

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

## Changes

- **2026-07-13** (1.0) `565d8813cbd3` — 3 info
  - added the new optional `query` request parameter `filter`
  - added the new optional `query` request parameter `maxpagesize`
  - added the new optional `query` request parameter `orderby`
- **2026-07-13** (1.0) `50c39d38d85a` — 3 warning
  - deleted the `query` request parameter `$filter`
  - deleted the `query` request parameter `$orderby`
  - deleted the `query` request parameter `$top`
- **2026-07-13** (1.0) `fc9ee2be8dc0` — 3 warning
  - deleted the `query` request parameter `$filter`
  - deleted the `query` request parameter `$orderby`
  - deleted the `query` request parameter `$top`
- **2026-07-13** (1.0) `bcae1054dfc8` — 3 info
  - added the new optional `query` request parameter `$filter`
  - added the new optional `query` request parameter `$orderby`
  - added the new optional `query` request parameter `$top`
- **2026-07-13** (1.0) `6536da9e32d7` — 3 info
  - added the new optional `query` request parameter `$filter`
  - added the new optional `query` request parameter `$orderby`
  - added the new optional `query` request parameter `$top`

[Full history](https://skmtc.dev/azure/apis/iotcentral-iotcentral/changes/deviceGroups/get.md)

---

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