---
title: "Changes to List Consumer Groups"
method: GET
path: "/clusters/{cluster_id}/consumer-groups"
---

# Changes to List Consumer Groups

`GET /clusters/{cluster_id}/consumer-groups`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 13 of 69 revisions.

- **2026-07-17** (v3) `e783c1a5e2bd`: 2 info
- **2024-12-05** (v3) `d15e96a7e423`: 1 warning, 1 info
- **2023-08-08** (v3) `25e5259d1722`: 1 breaking, 2 info
- **2023-08-08** (v3) `1be42847ed21`: 3 info
- **2023-03-10** (v3) `bb1cdf42f052`: 1 breaking, 2 info
- **2022-03-22** (v3) `7500cc59fcff`: 12 info
- **2022-03-22** (v3) `0b87d328c664`: 6 warning, 6 info
- **2022-01-18** (v3) `242a6e383b71`: 12 info
- **2022-01-18** (v3) `fbdd72178c66`: 6 warning, 6 info
- **2021-09-08** (v3) `2d4f120a2079`: 3 info
- **2021-09-01** (v3) `fc95920a3a26`: 9 info
- **2021-02-11** (v3) `40f26fdc96a4`: 1 breaking, 1 info
- **2021-02-08** (v3) `ba3b609556a7`: 1 info

## Changes

- **2026-07-17** (v3) `e783c1a5e2bd`: 2 info
  - added the required property `allOf[subschema #2]/data/items/allOf[subschema #2]/is_mixed_consumer_group` to the response with the `200` status
  - added the required property `allOf[subschema #2]/data/items/allOf[subschema #2]/type` to the response with the `200` status
- **2024-12-05** (v3) `d15e96a7e423`: 1 warning, 1 info
  - removed the optional property `allOf[subschema #2]/data/items/allOf[subschema #2]/consumer` from the response with the `200` status
  - added the required property `allOf[subschema #2]/data/items/allOf[subschema #2]/consumers` to the response with the `200` status
- **2023-08-08** (v3) `25e5259d1722`: 1 breaking, 2 info
  - removed the media type `text/plain` for the response with the status `400`
  - api operation id `listKafkaV3ConsumerGroups` removed and replaced with `listKafkaConsumerGroups`
  - added the non-success response with the status `403`
- **2023-08-08** (v3) `1be42847ed21`: 3 info
  - api operation id `listKafkaConsumerGroups` removed and replaced with `listKafkaV3ConsumerGroups`
  - added the media type `text/plain` for the response with the status `400`
  - removed the non-success response with the status `403`
- **2023-03-10** (v3) `bb1cdf42f052`: 1 breaking, 2 info
  - removed the media type `text/plain` for the response with the status `400`
  - api operation id `listKafkaV3ConsumerGroups` removed and replaced with `listKafkaConsumerGroups`
  - added the non-success response with the status `403`
- **2022-03-22** (v3) `7500cc59fcff`: 12 info
  - api operation id `listKafkaV3ConsumerGroups` was added
  - api tag `Consumer Group (v3)` added
  - api tag `Consumer Group` removed
  - added the non-success response with the status `400`
  - added the non-success response with the status `401`
  - added the non-success response with the status `429`
  - removed the `COMPLETING_REBALANCE` enum value from the `allOf[subschema #2]/data/items/allOf[subschema #2]/state` response property for the response status `200`
  - removed the `DEAD` enum value from the `allOf[subschema #2]/data/items/allOf[subschema #2]/state` response property for the response status `200`
  - removed the `EMPTY` enum value from the `allOf[subschema #2]/data/items/allOf[subschema #2]/state` response property for the response status `200`
  - removed the `PREPARING_REBALANCE` enum value from the `allOf[subschema #2]/data/items/allOf[subschema #2]/state` response property for the response status `200`
  - removed the `STABLE` enum value from the `allOf[subschema #2]/data/items/allOf[subschema #2]/state` response property for the response status `200`
  - removed the `UNKNOWN` enum value from the `allOf[subschema #2]/data/items/allOf[subschema #2]/state` response property for the response status `200`
- **2022-03-22** (v3) `0b87d328c664`: 6 warning, 6 info
  - added the new `COMPLETING_REBALANCE` enum value to the `allOf[subschema #2]/data/items/allOf[subschema #2]/state` response property for the response status `200`
  - added the new `DEAD` enum value to the `allOf[subschema #2]/data/items/allOf[subschema #2]/state` response property for the response status `200`
  - added the new `EMPTY` enum value to the `allOf[subschema #2]/data/items/allOf[subschema #2]/state` response property for the response status `200`
  - added the new `PREPARING_REBALANCE` enum value to the `allOf[subschema #2]/data/items/allOf[subschema #2]/state` response property for the response status `200`
  - added the new `STABLE` enum value to the `allOf[subschema #2]/data/items/allOf[subschema #2]/state` response property for the response status `200`
  - added the new `UNKNOWN` enum value to the `allOf[subschema #2]/data/items/allOf[subschema #2]/state` response property for the response status `200`
  - api operation id `listKafkaV3ConsumerGroups` removed and replaced with ``
  - api tag `Consumer Group` added
  - api tag `Consumer Group (v3)` removed
  - removed the non-success response with the status `400`
  - removed the non-success response with the status `401`
  - removed the non-success response with the status `429`
- **2022-01-18** (v3) `242a6e383b71`: 12 info
  - api operation id `listKafkaV3ConsumerGroups` was added
  - api tag `Consumer Group (v3)` added
  - api tag `Consumer Group` removed
  - added the non-success response with the status `400`
  - added the non-success response with the status `401`
  - added the non-success response with the status `429`
  - removed the `COMPLETING_REBALANCE` enum value from the `allOf[subschema #2]/data/items/allOf[subschema #2]/state` response property for the response status `200`
  - removed the `DEAD` enum value from the `allOf[subschema #2]/data/items/allOf[subschema #2]/state` response property for the response status `200`
  - removed the `EMPTY` enum value from the `allOf[subschema #2]/data/items/allOf[subschema #2]/state` response property for the response status `200`
  - removed the `PREPARING_REBALANCE` enum value from the `allOf[subschema #2]/data/items/allOf[subschema #2]/state` response property for the response status `200`
  - removed the `STABLE` enum value from the `allOf[subschema #2]/data/items/allOf[subschema #2]/state` response property for the response status `200`
  - removed the `UNKNOWN` enum value from the `allOf[subschema #2]/data/items/allOf[subschema #2]/state` response property for the response status `200`
- **2022-01-18** (v3) `fbdd72178c66`: 6 warning, 6 info
  - added the new `COMPLETING_REBALANCE` enum value to the `allOf[subschema #2]/data/items/allOf[subschema #2]/state` response property for the response status `200`
  - added the new `DEAD` enum value to the `allOf[subschema #2]/data/items/allOf[subschema #2]/state` response property for the response status `200`
  - added the new `EMPTY` enum value to the `allOf[subschema #2]/data/items/allOf[subschema #2]/state` response property for the response status `200`
  - added the new `PREPARING_REBALANCE` enum value to the `allOf[subschema #2]/data/items/allOf[subschema #2]/state` response property for the response status `200`
  - added the new `STABLE` enum value to the `allOf[subschema #2]/data/items/allOf[subschema #2]/state` response property for the response status `200`
  - added the new `UNKNOWN` enum value to the `allOf[subschema #2]/data/items/allOf[subschema #2]/state` response property for the response status `200`
  - api operation id `listKafkaV3ConsumerGroups` removed and replaced with ``
  - api tag `Consumer Group` added
  - api tag `Consumer Group (v3)` removed
  - removed the non-success response with the status `400`
  - removed the non-success response with the status `401`
  - removed the non-success response with the status `429`
- **2021-09-08** (v3) `2d4f120a2079`: 3 info
  - added the non-success response with the status `400`
  - added the non-success response with the status `401`
  - added the non-success response with the status `429`
- **2021-09-01** (v3) `fc95920a3a26`: 9 info
  - api operation id `listKafkaV3ConsumerGroups` was added
  - api tag `Consumer Group (v3)` added
  - api tag `Consumer Group` removed
  - removed the `COMPLETING_REBALANCE` enum value from the `allOf[subschema #2]/data/items/allOf[subschema #2]/state` response property for the response status `200`
  - removed the `DEAD` enum value from the `allOf[subschema #2]/data/items/allOf[subschema #2]/state` response property for the response status `200`
  - removed the `EMPTY` enum value from the `allOf[subschema #2]/data/items/allOf[subschema #2]/state` response property for the response status `200`
  - removed the `PREPARING_REBALANCE` enum value from the `allOf[subschema #2]/data/items/allOf[subschema #2]/state` response property for the response status `200`
  - removed the `STABLE` enum value from the `allOf[subschema #2]/data/items/allOf[subschema #2]/state` response property for the response status `200`
  - removed the `UNKNOWN` enum value from the `allOf[subschema #2]/data/items/allOf[subschema #2]/state` response property for the response status `200`
- **2021-02-11** (v3) `40f26fdc96a4`: 1 breaking, 1 info
  - removed the required property `allOf[subschema #2]/data/items/allOf[subschema #2]/lag` from the response with the `200` status
  - added the required property `allOf[subschema #2]/data/items/allOf[subschema #2]/lag_summary` to the response with the `200` status
- **2021-02-08** (v3) `ba3b609556a7`: 1 info
  - added the required property `allOf[subschema #2]/data/items/allOf[subschema #2]/lag` to the response with the `200` status

---

[Operation](https://skmtc.dev/confluentinc/apis/rest-admin-api/docs/clusters/:cluster_id/consumer-groups/get.md) - [API](https://skmtc.dev/confluentinc/apis/rest-admin-api.md) - [Page](https://skmtc.dev/confluentinc/apis/rest-admin-api/changes/clusters/:cluster_id/consumer-groups/get)