---
updatedAt: 2026-01-25T08:54:25.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 balance

# 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 balances and policies via the API, ensure the following permissions are set:

<Table align={["left","left","left"]}>
  <thead>
    <tr>
      <th>
        Data type / Method
      </th>

      <th>
        Permission
      </th>

      <th>
        Comment
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        Time off balance
      </td>

      <td>
        People's data > Time off > Balance > See selected people's time off and sick leave balances
        People's data > Time off > Balance > Adjust selected people's time off balances and bank their overtime.
      </td>

      <td>

      </td>
    </tr>
  </tbody>
</Table>

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 the balance for a given employee](https://apidocs.hibob.com/reference/get_timeoff-employees-id-balance) |        50        |
| POST   | [Create a balance adjustment](https://apidocs.hibob.com/reference/post_timeoff-employees-id-adjustments)     |        10        |