---
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

---

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