---
title: "GET /public/v1/clusters/{clusterName}/consumergroups/{consumerGroup}"
method: GET
path: "/public/v1/clusters/{clusterName}/consumergroups/{consumerGroup}"
tags: ["consumergroup"]
---

# GET /public/v1/clusters/{clusterName}/consumergroups/{consumerGroup}

`GET /public/v1/clusters/{clusterName}/consumergroups/{consumerGroup}`

## Request

- Base URL: `https://developers.conduktor.io` (the document declares no server; this is the origin it was published from)
- URL: `https://developers.conduktor.io/public/v1/clusters/{clusterName}/consumergroups/{consumerGroup}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/conduktor/apis/conduktor-console-api/docs/public/v1/clusters/:clusterName/consumergroups/:consumerGroup/get.ts> (a function with typed inputs; its response is checked against the schema)

Consumer group details

## Path parameters

- `clusterName` string, required
- `consumerGroup` string, required

## Response `200`

- ConsumerGroupDetails
  - `name` string, required
  - `state` 'Unknown' | 'PreparingRebalance' | 'CompletingRebalance' | 'Stable' | 'Dead' | 'Empty' | 'Assigning' | 'Reconciling', required
  - `consumeRateInSeconds` number, double
  - `overallLag` integer, required
  - `maxLagTimeInSeconds` integer
  - `labels` MapLabelKeyString, required
  - `members` Member[]
    - `id` string, required
    - `clientId` string
    - `host` string
  - `offsetPerPartition` OffsetPerPartition[]
    - `memberId` string
    - `topicName` string, required
    - `partition` integer, required
    - `lastCommittedOffset` integer
    - `partitionBeginningOffset` integer, required
    - `partitionEndOffset` integer, required
    - `lag` integer

## Other responses

- `400`: The request is not valid
- `401`: The user is not authenticated
- `403`: The user doesn't have the required permission(s) "kafka.groups.describe" to do this operation
- `404`: No cluster with this technical id exist
- `500`: An unexpected error occurred in the server

---

[API](https://skmtc.dev/conduktor/apis/conduktor-console-api.md) - [All operations](https://skmtc.dev/conduktor/apis/conduktor-console-api/llms.txt) - [OpenAPI document](https://skmtc.dev/conduktor/apis/conduktor-console-api/revisions/24750c294805?raw)