---
title: "GET /public/iam/v2/group"
method: GET
path: "/public/iam/v2/group"
tags: ["cli_group_iam_v2_1"]
---

# GET /public/iam/v2/group

`GET /public/iam/v2/group`

## 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/iam/v2/group`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/conduktor/apis/conduktor-console-api/docs/public/iam/v2/group/get.ts> (a function with typed inputs; its response is checked against the schema)

List Group resources

## Response `200`

- GroupResourceV2[]
  - `apiVersion` string, required
  - `kind` 'Group', required
  - `metadata` GroupMetadata, required
    - `name` string, required
  - `spec` GroupSpec, required
    - `displayName` string, required
    - `description` string
    - `externalGroups` string[]
    - `externalGroupRegex` string[]
    - `members` string[]
    - `membersFromExternalGroups` string[]
    - `permissions` ResourcePermissions1[]
      - union
        - CLUSTER
          - `name` string, required
          - `permissions` string[]
          - `resourceType` 'PLATFORM' | 'CLUSTER' | 'TOPIC' | 'CONSUMER_GROUP' | 'KAFKA_CONNECT' | 'SUBJECT' | 'KSQLDB', required
        - CONSUMERGROUP1
          - `cluster` string, required
          - `name` string, required
          - `patternType` 'LITERAL' | 'PREFIXED', required
          - `permissions` string[]
          - `resourceType` 'PLATFORM' | 'CLUSTER' | 'TOPIC' | 'CONSUMER_GROUP' | 'KAFKA_CONNECT' | 'SUBJECT' | 'KSQLDB', required
        - KAFKACONNECT
          - `cluster` string, required
          - `kafkaConnect` string, required
          - `name` string, required
          - `patternType` 'LITERAL' | 'PREFIXED', required
          - `permissions` string[]
          - `resourceType` 'PLATFORM' | 'CLUSTER' | 'TOPIC' | 'CONSUMER_GROUP' | 'KAFKA_CONNECT' | 'SUBJECT' | 'KSQLDB', required
        - KSQLDB
          - `cluster` string, required
          - `ksqlDB` string, required
          - `permissions` string[]
          - `resourceType` 'PLATFORM' | 'CLUSTER' | 'TOPIC' | 'CONSUMER_GROUP' | 'KAFKA_CONNECT' | 'SUBJECT' | 'KSQLDB', required
        - PLATFORM
          - `permissions` string[]
          - `resourceType` 'PLATFORM' | 'CLUSTER' | 'TOPIC' | 'CONSUMER_GROUP' | 'KAFKA_CONNECT' | 'SUBJECT' | 'KSQLDB', required
        - SUBJECT1
          - `cluster` string, required
          - `name` string, required
          - `patternType` 'LITERAL' | 'PREFIXED', required
          - `permissions` string[]
          - `resourceType` 'PLATFORM' | 'CLUSTER' | 'TOPIC' | 'CONSUMER_GROUP' | 'KAFKA_CONNECT' | 'SUBJECT' | 'KSQLDB', required
        - TOPIC1
          - `cluster` string, required
          - `name` string, required
          - `patternType` 'LITERAL' | 'PREFIXED', required
          - `permissions` string[]
          - `resourceType` 'PLATFORM' | 'CLUSTER' | 'TOPIC' | 'CONSUMER_GROUP' | 'KAFKA_CONNECT' | 'SUBJECT' | 'KSQLDB', required

## Other responses

- `400`: The request is not valid
- `401`: The user is not authenticated
- `403`: The user doesn't have sufficient privilege to do this operation
- `404`: No group with this name exists
- `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)