---
title: "List device groups"
method: GET
path: "/enterprise/{enterprise_id}/devicegroup/"
tags: ["esper_cloud_api_Device Group"]
---

# List device groups

`GET /enterprise/{enterprise_id}/devicegroup/`

Returns a paginated list of all device groups in the enterprise. Device groups organize devices into logical collections by location, use case, or deployment stage, and serve as the primary unit for policy assignment, app deployment, and bulk commands.

 **Common Use Cases** 
 
 Discovering group IDs for downstream operations; auditing group structure; populating group selectors in custom tools; confirming a group exists before assigning devices or Blueprints.

**Best Practices** 

Use the `name` query parameter to filter instead of fetching all groups; cache group IDs for use in commands and policy calls; paginate with `limit` and `offset` for large enterprises.

## Path parameters

- `enterprise_id` string, required

## Query parameters

- `name` string
- `limit` integer
- `offset` integer

## Response `200`

successful operation

- object
  - `count` integer, required
  - `next` string, url, nullable
  - `previous` string, url, nullable
  - `results` EsperCloudApiDeviceGroup[], required
    - `id` string, uuid — Group id
    - `name` string, required — Group name
    - `created_on` string, date-time — Date and time of when the group was created
    - `enterprise` string, url — Enterprise url
    - `parent` string, url — Parent group url
    - `device_count` integer — Count of devices in the group
    - `path` string — Path of the group
    - `children_count` integer — Count of child groups
    - `thumbnail` string, uuid — thumbnail associated with the group
    - `blueprint` string, uuid — Blueprint associated with the group.

## Other responses

- `401` — Authorization information is missing or invalid.
- `404` — Not Found.
- `500` — Internal server error

---

[API](https://skmtc.net/esper/apis/esper-api-reference.md) · [All operations](https://skmtc.net/esper/apis/esper-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/esper/esper-api-reference/versions/e1f64cbb488e/schema)