---
title: "Find all groups on a workspace"
method: GET
path: "/v1/workspaces/{workspaceId}/user-groups"
tags: ["Group"]
---

# Find all groups on a workspace

`GET /v1/workspaces/{workspaceId}/user-groups`

## Path parameters

- `workspaceId` string, required — Represents a workspace identifier across the system.

## Query parameters

- `project-id` string
- `name` string — If provided, you'll get a filtered list of groups that matches the string provided in their name.
- `sort-column` 'ID' | 'NAME'
- `sort-order` 'ASCENDING' | 'DESCENDING'
- `page` integer — Page number.
- `page-size` integer — Page size.
- `includeTeamManagers` boolean — If provided, you'll get a list of team managers assigned to this user group.

## Response `200`

OK

- UserGroupDtoV1[]
  - `id` string — Represents a user group identifier across the system.
  - `name` string — Represents a user group name.
  - `teamManagers` UserRedactedDtoV1[] — Represents a list of assigned team managers for this user group.
    - `id` string
    - `name` string
  - `userIds` string[] — Represents a list of users' identifiers across the system.
  - `workspaceId` string — Represents a workspace identifier across the system.

## Changes

- **2026-08-20** `a5b636acbcd8` — 1 breaking, 4 info
  - for the `query` request parameter `name`, default value `` was added
  - the `` response's property default value `` was added for the status `200`
  - the `id` response's property default value `` was added for the status `200`
  - the `name` response's property default value `` was added for the status `200`
  - …1 more

[Change history](https://skmtc.dev/clockify/apis/clockify-api/changes/v1/workspaces/:workspaceId/user-groups/get.md)

---

[API](https://skmtc.dev/clockify/apis/clockify-api.md) · [All operations](https://skmtc.dev/clockify/apis/clockify-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/clockify/clockify-api/revisions/a5b636acbcd8/schema)