---
title: "Get Consumer Group Detail"
method: GET
path: "/consumer-groups/{group_id}"
tags: ["Consumer Groups"]
---

# Get Consumer Group Detail

`GET /consumer-groups/{group_id}`

Get detailed information about a specific consumer group.

Returns all members and paginated topic-partition assignments with member attribution.
Use include_assignments=false for large consumer groups to skip assignment details.

Pagination applies to topics, not members (all members are returned).

Security: Consumer groups are tenant-isolated via k8s_namespace. Each tenant has their own
Kafka cluster, so consumer groups from other tenants are not accessible.

## Path parameters

- `group_id` string, required

## Query parameters

- `page` integer — Page number for topics (1-indexed)
- `page_size` integer — Topics per page
- `include_assignments` boolean — Include partition assignment details (set false for large groups)
- `topic_search` string, nullable — Search topics by name (case-insensitive substring match)

## Response `200`

Successful Response

- ConsumerGroupDetail — Detailed consumer group information with paginated topics.
  - `group_id` string, required — Consumer group ID
  - `state` string, required — Group state
  - `is_simple_consumer_group` boolean, required — Whether this is a simple (legacy) consumer group
  - `partition_assignor` string, nullable — Partition assignment strategy
  - `members` ConsumerGroupMember[] — List of all members
    - `member_id` string, required — Unique member ID
    - `client_id` string, required — Client application ID
    - `host` string, required — Consumer host
  - `total_members` integer, required — Total number of members
  - `topics` TopicPartitionAssignment[] — Paginated list of topic-partition assignments
    - `topic` string, required
    - `partition` integer, required
    - `member_id` string, required — Member ID that owns this partition
    - `current_offset` integer, nullable — Current committed offset
    - `log_end_offset` integer, nullable — Latest offset in partition
    - `lag` integer, nullable — Consumer lag (log_end_offset - current_offset)
  - `total_topics` integer, required — Total number of topic-partition assignments
  - `page` integer, required — Current page number (for topics pagination)
  - `page_size` integer, required — Topics per page (for pagination)
  - `total_lag` integer — Total lag across all partitions
  - `coordinator` string, nullable — Group coordinator broker

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