---
updatedAt: 2025-12-23T15:33:16.000Z
---

Fetch the complete documentation index at: https://apidocs.hibob.com/llms.txt. Use this file to discover all available pages before exploring further.

# Time off policies

# Getting started

Before you start [explore the Time off API](/docs/explore-time-off-api)  to understand how the Public API supports time-off workflows and how to access Time off requests and policies

# Required Permissions

To access time off policies via the API, ensure the following permissions are set:

| Data type / Method     | Permission                                                          | Comment                                   |
| :--------------------- | :------------------------------------------------------------------ | :---------------------------------------- |
| Policy Type & Policies | Features > Time off > Settings > Manage company's time off settings | Note that this is a "Features" permission |

To learn more about setting permissions for service users, see [API Service Users](https://apidocs.hibob.com/docs/api-service-users).

# Rate limiting

Rate limits are restrictions that our API imposes on the number of times a user can access our endpoints within a specified period of time. To learn more about rate limiting best practices, see [Rate limiting](https://apidocs.hibob.com/docs/rate-limit).

Below is a table detailing the rate limits for each endpoint in the Time off endpoints.

| Method | Endpoint                                                                                                                                    | Limit per minute |
| :----- | :------------------------------------------------------------------------------------------------------------------------------------------ | :--------------: |
| GET    | [Get Policy type reason codes](https://apidocs.hibob.com/reference/get_timeoff-policy-types-policytype-reason-codes)                        |        10        |
| POST   | [Add a list of reason codes for a given policy type](https://apidocs.hibob.com/reference/post_timeoff-policy-types-policytype-reason-codes) |        10        |
| GET    | [Get Policy type details](https://apidocs.hibob.com/reference/get_timeoff-policy-types-policytype)                                          |        50        |
| GET    | [Get all policy types names](https://apidocs.hibob.com/reference/get_timeoff-policy-types)                                                  |        50        |
| GET    | [Get Policy details](https://apidocs.hibob.com/reference/get_timeoff-policies)                                                              |        50        |
| GET    | [Get a list of policy names for a given policy type](https://apidocs.hibob.com/reference/get_timeoff-policies-names)                        |        50        |