---
title: "List groups"
method: GET
path: "/api/1/groups"
tags: ["Groups (Preferred)"]
---

# List groups

`GET /api/1/groups`

Returns a paginated list of groups with member count.

Requires the **GROUPMANAGEMENT** security role.

## Query parameters

- `search_term` string
- `ids[]` string[]
- `sort` 'name' | 'description' | '-name' | '-description'
- `start` integer
- `limit` integer

## Response `200`

Successful response

- object
  - `items` Group[]
    - `id` string, uuid
    - `title` string
    - `description` string
    - `guideIds` string[]
    - `guides` GuideOverview[]
      - `id` string, uuid
      - `creationTime` string
      - `lastModifiedTime` string
      - `title` string
      - `visibility` 'PRIVATE' | 'SPECIFIC' | 'PORTAL' | 'PUBLIC'
      - `version` integer
      - `ownerId` string
      - `cover` Cover
        - `assetId` string
        - `assetName` string
        - `imageUrl` string
        - `detailUrl` string
      - `isFeatured` boolean
      - `type` 'MULTI_PAGE' | 'SINGLE_PAGE' | 'HOME_PAGE'
      - `groupId` string, uuid
      - `canEdit` boolean
      - `canView` boolean
      - `shared` boolean
      - `targetedPagesEnabled` boolean
    - `visibility` 'PRIVATE' | 'SPECIFIC' | 'PORTAL' | 'PUBLIC'
    - `ownerId` string
    - `version` integer
    - `creationTime` string
    - `lastModifiedTime` string
    - `cover` object
      - `colorId` string
      - `assetId` string
      - `assetName` string
      - `imageUrl` string
      - `detailUrl` string
    - `canEdit` boolean
    - `canView` boolean
    - `shared` boolean
  - `metadata` object
    - `prevPage` string, nullable — Relative URL of the previous page, or null if on the first page.
    - `nextPage` string, nullable — Relative URL of the next page, or null if on the last page.

## Other responses

- `400` — Unsupported `sort` value.
- `401` — Missing or invalid authentication. The response body is empty.
- `403` — The authenticated user does not have the **GROUPMANAGEMENT** security role.
- `422` — Validation error (e.g. `start` less than 1, `limit` outside 1–1000, malformed group ID in `ids[]`).

---

[API](https://skmtc.net/bynder/apis/oauth-2-0.md) · [All operations](https://skmtc.net/bynder/apis/oauth-2-0/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bynder/oauth-2-0/versions/bb9efc864ce1/schema)