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

# Find all users on a workspace

`GET /v1/workspaces/{workspaceId}/users`

## Path parameters

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

## Query parameters

- `email` string — If provided, you'll get a filtered list of users that contain the provided string in their email address.
- `project-id` string
- `status` 'PENDING' | 'ACTIVE' | 'DECLINED' | 'INACTIVE' | 'ALL'
- `account-statuses` string
- `name` string — If provided, you'll get a filtered list of users that contain the provided string in their name
- `sort-column` 'ID' | 'EMAIL' | 'NAME' | 'NAME_LOWERCASE' | 'ACCESS' | 'HOURLYRATE' | 'COSTRATE'
- `sort-order` 'ASCENDING' | 'DESCENDING'
- `page` integer — Page number.
- `page-size` integer — Page size.
- `memberships` 'ALL' | 'NONE' | 'WORKSPACE' | 'PROJECT' | 'USERGROUP'
- `include-roles` string, required

## Response `200`

OK

- UserDtoV1[] — unresolved $ref

## Changes

- **2026-08-20** `a5b636acbcd8` — 2 breaking, 26 info
  - for the `query` request parameter `email`, default value `` was added
  - for the `query` request parameter `name`, default value `` was added
  - the `activeWorkspace` response's property default value `` was added for the status `200`
  - the `currency` response's property default value `` was added for the status `200`
  - …24 more

[Change history](https://skmtc.dev/clockify/apis/clockify-api/changes/v1/workspaces/:workspaceId/users/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)