User

Find all users on a workspace

Changed on Aug 20, 2026

get/v1/workspaces/{workspaceId}/users

Request

Base URL: https://api.clockify.me/api
URL: https://api.clockify.me/api/v1/workspaces/{workspaceId}/users
Auth: one of:
- API key in header x-api-key
- API key in header x-addon-token

Path parameters

workspaceIdstring required

Represents a workspace identifier across the system.

Example:64a687e29ae1f428e7ebe303

Query parameters

emailstring

If provided, you'll get a filtered list of users that contain the provided string in their email address.

Example:mail@example.com

project-idstring

If provided, you'll get a list of users that have access to the project.

status'PENDING' | 'ACTIVE' | 'DECLINED' | 'INACTIVE' | 'ALL'

If provided, you'll get a filtered list of users with the corresponding status.

account-statusesstring

If provided, you'll get a filtered list of users with the corresponding account status filter. If not, this will only filter ACTIVE, PENDING_EMAIL_VERIFICATION, and NOT_REGISTERED Users.

namestring

If provided, you'll get a filtered list of users that contain the provided string in their name

Example:John

Sorting column criteria. Default value: EMAIL

sort-order'ASCENDING' | 'DESCENDING'

Sorting mode. Default value: ASCENDING

pageinteger

Page number.

Example:1

page-sizeinteger

Page size.

Example:50

memberships'ALL' | 'NONE' | 'WORKSPACE' | 'PROJECT' | 'USERGROUP'

If provided, you'll get all users along with workspaces, groups, or projects they have access to. Default value is NONE.

include-rolesstring required

If you pass along includeRoles=true, you'll get each user's detailed manager role (including projects and members which they manage)

Response

UserDtoV1[] required(unresolved $ref)

Changes

Aug 20, 2026a5b636acbcd8 Revision changes
- breaking
  for the query request parameter email, default value was added
- breaking
  for the query request parameter name, default value was added
- info
  the response's property default value was added for the status
- info
  the response's property default value was added for the status
- info
  the response's property default value was added for the status
- info
  the response's property default value was added for the status
- info
  the response's property default value was added for the status
- info
  the response's property default value was added for the status
- info
  the response's property default value was added for the status
- info
  the response's property default value was added for the status
- info
  the response's property default value was added for the status
- info
  the response's property default value was added for the status
- info
  the response's property default value was added for the status
- info
  the response's property default value was added for the status
- info
  the response's property default value was added for the status
- info
  the response's property default value was added for the status
- info
  the response's property default value was added for the status
- info
  the response's property default value was added for the status
- info
  the response's property default value was added for the status
- info
  the response's property default value was added for the status
- info
  the response's property default value was added for the status
- info
  the response's property default value was added for the status
- info
  the response's property default value was added for the status
- info
  the response's property default value was added for the status
- info
  the response's property default value was added for the status
- info
  the response's property default value was added for the status
- info
  the response's property default value was added for the status
- info
  the response's property default value was added for the status

Operation history