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

# List groups

`GET /groups`

## Request

- Base URL: `https://api.echtpost.de/v2`
- URL: `https://api.echtpost.de/v2/groups`
- Auth: one of:
  - OAuth 2 (authorization code, authorization URL `https://my.echtpost.de/oauth/authorize`, token URL `https://my.echtpost.de/oauth/token`, scopes: `mcp`)
  - API key in header `X-Api-Key`
  - HTTP bearer

## Query parameters

- `page` integer
- `per_page` integer
- `sort` 'name' | 'created_at' | 'updated_at'
- `direction` 'asc' | 'desc'

## Response `200`

OK

- Group[]
  - `id` integer
  - `name` string
  - `external_id` string, nullable
  - `recipient_count` integer
  - `created_at` string, date-time
  - `updated_at` string, date-time

## Other responses

- `401`: Authentication required

---

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