---
title: "List groups"
method: POST
path: "/list-groups"
---

# List groups

`POST /list-groups`

Retrieves a list of groups associated with the specified company. Each group includes its ID, name, description, and a list of its members.

**Parameters:**

-   `companyKey` _(string, required)_ - The company's secret key.

## Request body

- ListGroups
  - `companyKey` string

## Response `200`

Success

- ListGroupsResponse
  - `result` object[]
    - `id` string
    - `name` string
    - `description` string
    - `memberUserIds` string[]

## Other responses

- `400` — ArgumntError

## Changes

- **2026-08-12** `cda4b2b11372` — 1 info
  - added the optional property `result/items/description` to the response with the `200` status

[Change history](https://skmtc.dev/identomat/apis/generated-api/changes/list-groups/post.md)

---

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