---
title: "Get User Groups"
method: GET
path: "/v1/admin/user-groups"
tags: ["beta.admin.user-groups"]
---

# Get User Groups

`GET /v1/admin/user-groups`

Get all user groups across the organization.

## Query parameters

- `page` integer — Page number to return.
- `page_size` integer — Maximum number of results per page.
- `search` string, nullable — Search term used to filter user groups by name.

## Response `200`

OK

- AdminUserGroupsOut
  - `total` integer, required — Total number of user groups that match the request.
  - `items` AdminUserGroupOut[], required — User groups on this page.
    - `uuid` string, uuid, required — User group ID.
    - `name` string, required — Name of the user group.
    - `description` string, nullable, required — Optional description of the user group.
    - `externally_managed` boolean, nullable — Whether the group is managed by an external system.
    - `target_type` 'W' | 'O'
    - `organization_role` string, nullable — Organization role assigned to the group.
  - `page` integer, required — Page number returned.
  - `page_size` integer, required — Maximum number of results per page.

---

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