---
title: "List All Groups"
method: GET
path: "/api/platform/groups"
tags: ["platform"]
---

# List All Groups

`GET /api/platform/groups`

List groups the caller can ``data_reader`` on, paginated and searchable.

The members-groups page itself requires module ``reader`` (the gate above);
the rows are then filtered to the groups the caller has ``data_reader`` on,
so a delegate only sees their own groups while a dock operator sees all.

## Query parameters

- `page` integer
- `per_page` integer
- `q` string
- `include_system_groups` boolean

## Response `200`

Successful Response

- PlatformGroupsPaginatedResponse — Paginated list envelope for groups with search support.
  - `items` PlatformGroup[]
    - `id` string, required
    - `organizationId` string, required
    - `organizationName` string, nullable
    - `displayName` string, nullable
    - `description` string, nullable
    - `memberCount` integer
    - `isAllMembers` boolean
    - `fgaSyncStatus` string
    - `fgaLastError` string, nullable
    - `fgaLastReconciledAt` string, date-time, nullable
    - `createdAt` string, date-time, nullable
    - `updatedAt` string, date-time, nullable
  - `total` integer

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/gocrisp/apis/crisp-app-dock.md) · [All operations](https://skmtc.dev/gocrisp/apis/crisp-app-dock/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/gocrisp/crisp-app-dock/revisions/e56bd3c1a9db/schema)