---
title: "Get groups by organization (paginated)"
method: GET
path: "/api/v2/organizations/{organization}/paginated-groups"
tags: ["Enterprise"]
---

# Get groups by organization (paginated)

`GET /api/v2/organizations/{organization}/paginated-groups`

Unlike "Get groups by organization" (GET /organizations/{organization}/groups),
which authorizes each group individually via its ACL, this endpoint requires
organization-wide group read permission and does no per-group filtering. It is
therefore not a drop-in replacement: callers without org-wide group read receive
an error rather than a filtered subset.

The `q` parameter uses the shared filter syntax. Bare terms (including multi-word)
perform a free-text search over group name and display name. `search:` is the only
accepted key and unknown keys return 400. Because group display names may contain
colons, a value with a colon must be quoted, e.g. `search:"team: frontend"`; an
unquoted colon fails with `Query element "team:" cannot start or end with ':'`.

This endpoint returns group summaries without the member roster: each group
carries only `total_member_count` and no `members` field. Callers that need the
roster use the group members endpoint (GET /groups/{group}/members).

## Path parameters

- `organization` string, required

## Query parameters

- `q` string
- `limit` integer
- `offset` integer
- `after_id` string, uuid

## Response `200`

OK

- CodersdkPaginatedGroupsResponse
  - `count` integer
  - `groups` CodersdkPaginatedGroup[]
    - `avatar_url` string, uri
    - `display_name` string
    - `id` string, uuid
    - `name` string
    - `organization_display_name` string
    - `organization_id` string, uuid
    - `organization_name` string
    - `quota_allowance` integer
    - `source` 'user' | 'oidc'
    - `total_member_count` integer — TotalMemberCount is the number of members in the group, shown even when the caller cannot read individual members. The roster itself is not returned by this endpoint.

---

[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/revisions/50a77af44008/schema)