---
title: "Get group by ID"
method: GET
path: "/api/1/groups/{groupId}"
tags: ["Groups (Preferred)"]
---

# Get group by ID

`GET /api/1/groups/{groupId}`

Returns a single group by its ID, including member count.

Requires the **GROUPMANAGEMENT** security role.

## Path parameters

- `groupId` string, uuid, required

## Response `200`

Successful response

- 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

## Other responses

- `401` — Missing or invalid authentication. The response body is empty.
- `403` — The authenticated user does not have the **GROUPMANAGEMENT** security role.
- `404` — Group not found.
- `422` — Validation error (malformed group ID).

---

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