---
title: "Get group by ID"
method: GET
path: "/api/v2/groups/{group}"
tags: ["Enterprise"]
---

# Get group by ID

`GET /api/v2/groups/{group}`

## Path parameters

- `group` string, required

## Query parameters

- `exclude_members` boolean

## Response `200`

OK

- CodersdkGroup
  - `avatar_url` string, uri
  - `display_name` string
  - `id` string, uuid
  - `members` CodersdkReducedUser[]
    - `avatar_url` string, uri
    - `created_at` string, date-time, required
    - `email` string, email, required
    - `id` string, uuid, required
    - `is_service_account` boolean
    - `last_seen_at` string, date-time
    - `login_type` '' | 'password' | 'github' | 'oidc' | 'token' | 'none'
    - `name` string
    - `status` 'active' | 'dormant' | 'suspended'
    - `theme_preference` string — Deprecated: this value should be retrieved from `codersdk.UserPreferenceSettings` instead.
    - `updated_at` string, date-time
    - `username` string, required
  - `name` string
  - `organization_display_name` string
  - `organization_id` string, uuid
  - `organization_name` string
  - `quota_allowance` integer
  - `source` 'user' | 'oidc'
  - `total_member_count` integer — How many members are in this group. Shows the total count, even if the user is not authorized to read group member details. May be greater than `len(Group.Members)`.

---

[API](https://skmtc.net/coder/apis/coder-api.md) · [All operations](https://skmtc.net/coder/apis/coder-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/coder/coder-api/versions/56b6e9f08540/schema)