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

# List Groups

`GET /v1/groups`

Use this endpoint to list all predefined groups available in the system.

## Query parameters

- `page` integer
- `limit` integer

## Response `200`

The list of all predefined groups available in the system.

- object
  - `items` GroupResponse[], required
    - `createdAt` string — Timestamp of when the group was created.
    - `id` string — Unique identifier of the group.
    - `name` string — Display name of the group.
    - `users` string[] — List of users assigned to the group.
  - `limit` integer, required
  - `next_cursor` string
  - `page` integer
  - `prev_cursor` string

## Other responses

- `404`
- `500`

---

[API](https://skmtc.net/lerian/apis/identity-plugin.md) · [All operations](https://skmtc.net/lerian/apis/identity-plugin/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lerian/identity-plugin/versions/25daba385532/schema)