---
title: "Get policies on a workspace"
method: GET
path: "/v1/workspaces/{workspaceId}/time-off/policies"
tags: ["Policy"]
---

# Get policies on a workspace

`GET /v1/workspaces/{workspaceId}/time-off/policies`

## Path parameters

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

## Query parameters

- `page` string
- `page-size` integer — Page size.
- `name` string — If provided, you'll get a filtered list of policies that contain the provided string in their name.
- `status` 'ACTIVE' | 'ARCHIVED' | 'ALL'
- `sort-column` string
- `sort-order` string

## Response `200`

OK

- PolicyDtoV1[]
  - `allowHalfDay` boolean — Indicates whether the half day is allowed.
  - `allowNegativeBalance` boolean — Indicates whether the negative balance is allowed.
  - `approve` PolicyApprovalDto — Represents approval settings.
    - `requiresApproval` boolean — Indicates whether it requires approval
    - `specificMembers` boolean — Indicates whether it requires specific members
    - `teamManagers` boolean — Indicates whether it requires team manager's approval
    - `userIds` string[] — Represents set of user's identifier across the system
  - `archived` boolean — Indicates whether the policy is archived.
  - `automaticAccrual` AutomaticAccrualDto — Represents automatic approval settings.
    - `amount` number, double — Represents automatic accrual's amount
    - `period` 'MONTH' | 'YEAR' — Represents automatic accrual's period
    - `timeUnit` 'DAYS' | 'HOURS' — Represents automatic accrual's time unit
  - `automaticTimeEntryCreation` AutomaticTimeEntryCreationDto — Represents automatic time entry creation settings.
    - `defaultEntities` DefaultEntitiesDto
      - `projectId` string
      - `taskId` string
    - `enabled` boolean
  - `color` string — Represents the color assigned to the policy.
  - `everyoneIncludingNew` boolean — Indicates whether the policy is applied to future new users.
  - `icon` 'UMBRELLA' | 'SNOWFLAKE' | 'FAMILY' | 'PLANE' | 'STETHOSCOPE' | 'HEALTH_METRICS' | 'CHILDCARE' | 'LUGGAGE' | 'MONETIZATION' | 'CALENDAR' — Represents the icon assigned to the policy.
  - `id` string — Represents policy identifier across the system.
  - `name` string — Represents the name of the policy.
  - `negativeBalance` NegativeBalanceDto — Represents the data about negative balance including amount, time unit and period.
    - `amount` number, double
    - `period` string
    - `shouldReset` boolean
    - `timeUnit` string
  - `projectId` string — Represents project identifier across the system.
  - `timeUnit` 'DAYS' | 'HOURS' — Represents the time unit of the policy.
  - `userGroupIds` string[] — Represents user groups' identifiers across the system. Indicates which user groups are included in the policy.
  - `userIds` string[] — Represents users' identifiers across the system. Indicates which users are included in the policy.
  - `workspaceId` string — Represents workspace identifier across the system.

## Changes

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

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