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

# List Consumer Groups

`GET /consumer-groups`

List consumer groups for the tenant with pagination.
Excludes internal/system consumer groups.

## Query parameters

- `page` integer — Page number (1-indexed)
- `page_size` integer — Items per page
- `state` string, nullable — Filter by state. Comma-separated for multiple values (e.g., 'Dead,Empty'). Valid states: Stable, Empty, Dead, PreparingRebalance, CompletingRebalance, Unknown
- `search` string, nullable — Search by group ID (case-insensitive substring match)

## Response `200`

Successful Response

- ConsumerGroupsPaginatedRes — Paginated consumer groups list response.
  - `page` integer, required — Current page number
  - `page_size` integer, required — Items per page
  - `total` integer, required — Total number of consumer groups
  - `result` ConsumerGroupListItem[], required — List of consumer groups
    - `group_id` string, required — Consumer group ID
    - `state` string, required — Group state (e.g., Stable, Empty, Dead)
    - `member_count` integer — Number of active members

## Other responses

- `422` — Validation Error

---

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