---
title: "GET /accounts/{account_pk}/groups"
method: GET
path: "/accounts/{account_pk}/groups"
tags: ["Accounts"]
---

# GET /accounts/{account_pk}/groups

`GET /accounts/{account_pk}/groups`

## Path parameters

- `account_pk` string, required

## Query parameters

- `limit` integer
- `offset` integer
- `description` string
- `events.created.at` string, date-time
- `external_id` string
- `id` string
- `name` string
- `permissions.id` string
- `permissions.object.id` string
- `stats.users` integer

## Response `200`

- AuthGroup[]
  - `id` string, required
  - `name` string, required
  - `description` string, required
  - `color` string, nullable
  - `external_id` string, nullable
  - `revision` integer, required
  - `events` object
    - `created` object
      - `at` string, datetime
      - `by` object
        - `id` string
        - `name` string
        - `icon` string
    - `updated` object
      - `at` string, datetime
      - `by` object
        - `id` string
        - `name` string
        - `icon` string
    - `decommissioned` object
      - `at` string, datetime
      - `by` object
        - `id` string
        - `name` string
        - `icon` string
  - `permissions` object[], required
    - `id` string
    - `object` object
      - `id` string
    - `events` object
      - `granted` object
        - `at` string, date-time
        - `by` object
          - `id` string
          - `name` string
    - `privilege` 'viewer' | 'editor'
  - `stats` AuthGroupStats
    - `users` integer, required

## Other responses

- `400`

---

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