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

# Get a time off policy

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

## Path parameters

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

## 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` — 12 info
  - the `` response's property default value `` was added for the status `200`
  - the `` response's property default value `` was added for the status `200`
  - the `` response's property default value `` was added for the status `200`
  - the `color` response's property default value `` was added for the status `200`
  - …8 more

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