---
title: "List Groups By Organizations"
method: GET
path: "/api/platform/groups/by-organization"
tags: ["platform"]
---

# List Groups By Organizations

`GET /api/platform/groups/by-organization`

List groups for one or more organizations in a single request.

Resolves visibility via one ``list_objects`` call and one DB query instead of
fanning out per-organization requests that each scanned the FGA store.

## Query parameters

- `orgId` string[], required

## Response `200`

Successful Response

- PlatformGroupsListResponse — List envelope for groups under an organization.
  - `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

## 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)