---
title: "Get Policy details."
method: GET
path: "/timeoff/policies"
tags: ["Time off policies"]
---

# Get Policy details.

`GET /timeoff/policies`

Get details about a given policy.<br /> <br /> **Permissions required**: Please refer to the main <a href="https://apidocs.hibob.com/reference/time-off#required-permissions">Time off API Required Permissions</a> page.

## Query parameters

- `policyName` string, required

## Response `200`

Policy

- Policy
  - `name` string
  - `allowance` number — Base annual allowance.
  - `maxBalance` number — Maximum balance at the end of the cycle.
  - `minBalance` number — Minimum balance cap.
  - `yosIncrease` YearsOfServiceIncrements[]
    - `yearsOfService` number — Start after this number of years.
    - `extraDays` number — Additional days to add.
  - `minTimeOffRequestDuration` 'fullDay' | 'halfDay' | 'fullHour' | 'halfHour' | 'quarterHour' | 'tenMinutes' — The shortest amount of time employees can request.
  - `bookingWorkDaysOnly` boolean — This property defines whether non-working days such as weekends and bank holidays will be deducted from the balance. <br /><br /> **Change in behavior starting November 20, 2024**: From this date, the `bookingWorkDaysOnly` setting has moved from the **Policy Type** to the **Policy** details. Policies that were created before this date will return the original value from the policy type.
  - `approvalRequired` boolean — Requests require approval.
  - `description` string — Policy description.
  - `unit` 'days' | 'hours'

## Other responses

- `404` — A policy with the specified name was not found.

---

[API](https://skmtc.net/hibob/apis/employee-data-api.md) · [All operations](https://skmtc.net/hibob/apis/employee-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hibob/employee-data-api/revisions/0781ebbdda91/schema)