---
title: "Group list"
method: GET
path: "/api/groups"
tags: ["Groups"]
---

# Group list

`GET /api/groups`

## Request

- Base URL: `https://dregs.com`
- URL: `https://dregs.com/api/groups`
- Auth: HTTP bearer

List groups of every type, or of one type, optionally only those an identity belongs to

## Query parameters

- `request` V1ListGroupsRequest, required
  - `pageNumber` integer
  - `pageSize` integer
  - `order` 'ASC' | 'DESC'
  - `sort` string
  - `type` string
  - `identity` string
  - `term` string

## Response `200`

Groups retrieved

## Other responses

- `400`: Invalid group type
- `401`: Authentication required

---

[API](https://skmtc.dev/dregs/apis/dregs-api.md) · [All operations](https://skmtc.dev/dregs/apis/dregs-api/llms.txt) · [OpenAPI document](https://skmtc.dev/dregs/apis/dregs-api/revisions/ea71f8c1eed4?raw)