---
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.

---

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