---
title: "List groups"
method: GET
path: "/v2/groups"
tags: ["Groups"]
---

# List groups

`GET /v2/groups`

Retrieve a paginated list of user groups

## Query parameters

- `page_after` string
- `page_size` integer

## Response `200`

Successfully retrieved groups

- GroupListResponseDto — Paginated list of groups
  - `groups` GroupDto[] — List of groups
    - `created_at` string, date-time — Group creation date
    - `display_name` string — Group name
    - `id` string — Unique identifier for the group
    - `last_refresh_at` string, date-time — Group membership last updated date (can be null if initial membership calculation is still in progress)
    - `status` 'ACTIVE' | 'ARCHIVED' — Group status
    - `type` 'GENERAL' | 'NEW_HIRE' | 'REMEDIATION' — Group type
  - `page_after` string — Cursor for the next page

## Other responses

- `400` — Bad request - Invalid parameters
- `401` — Unauthorized - Invalid or missing authentication token
- `429` — Too many requests - Rate limit exceeded
- `500` — Internal server error

---

[API](https://skmtc.dev/adaptivesecurity/apis/adaptive-api.md) · [All operations](https://skmtc.dev/adaptivesecurity/apis/adaptive-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/adaptivesecurity/adaptive-api/revisions/aaa99c15ecc7/schema)