# Developer Docs Documentation

> The Developer Docs is where you'll find comprehensive guides and documentation to help you start working with Bob as quickly as possible.

This file lists one part of the documentation. The full index is at https://apidocs.hibob.com/llms.txt.

## API Reference: Time Off API
- [Time off requests](https://apidocs.hibob.com/reference/time-off.md): The Time off API provides access to the details of your company time off   requests and policies.
  - [Submit a new time off request.](https://apidocs.hibob.com/reference/post_timeoff-employees-id-requests.md): Submits a new time off request.<br /> <br />Time off requests can be of the listed types in the body params section below.<br /> <br />Each request type requires different parameters in the body…
  - [Get the details of an existing time off request.](https://apidocs.hibob.com/reference/get_timeoff-employees-id-requests-requestid.md): Retrieve the detailed info about an existing time off request.<br> <br>  <b>Possible time off request types:</b> <ul>   <li><b>days</b>: the request is for X days.</li>   <li>     <b>hours</b>: the…
  - [Cancel an existing time off request](https://apidocs.hibob.com/reference/delete_timeoff-employees-id-requests-requestid.md): Cancels an existing time off request.<br /> <br /> **Permissions required**: Please refer to the main <a href="https://apidocs.hibob.com/reference/time-off#required-permissions">Time off API Required…
  - [Get time off requests changes](https://apidocs.hibob.com/reference/get_timeoff-requests-changes.md): Returns an array of all changes made to time off requests within a specified date range. Each item in the array includes: the time off request details at the time of the change, and the type of…
  - [Read a list of who's out of the office.](https://apidocs.hibob.com/reference/get_timeoff-whosout.md): Returns time off information for a given date range, only for the users the Service User can access.<br /><br />  <b>Possible time off request types:</b> <ul>   <li><b>days</b>: the request is for X…
  - [Read a list of who's out of the office today or on the specified date.](https://apidocs.hibob.com/reference/get_timeoff-outtoday.md): Returns the list of people that have a time off request today or on the specified date, only for the users the Service User can access.<br /><br /> <b>Possible time off request types…
- [Time off balance](https://apidocs.hibob.com/reference/time-off-balance.md)
  - [Get the balance for a given employee](https://apidocs.hibob.com/reference/get_timeoff-employees-id-balance.md): Retrieve the balance for a given employee, for a given policy type, as of a given date.<br /> <br /> **Permissions required**: Please refer to the main <a…
  - [Create a balance adjustment.](https://apidocs.hibob.com/reference/post_timeoff-employees-id-adjustments.md): Create a balance adjustment for a given employee for a given effective date.<br /> <br /> **Permissions required**: Please refer to the main <a…
- [Time off policies](https://apidocs.hibob.com/reference/time-off-policies.md)
  - [Get Policy type reason codes](https://apidocs.hibob.com/reference/get_timeoff-policy-types-policytype-reason-codes.md): Get list of reason codes for a given policy type.<br /> <br /> **Permissions required**: Please refer to the main <a href="https://apidocs.hibob.com/reference/time-off#required-permissions">Time off…
  - [Add a list of reason codes for a given policy type.](https://apidocs.hibob.com/reference/post_timeoff-policy-types-policytype-reason-codes.md): Add a list of reason codes for a given policy type.<br /><b>Supported user types:</b> Service. <br /> **Permissions required**: Please refer to the main <a…
  - [Get Policy type details](https://apidocs.hibob.com/reference/get_timeoff-policy-types-policytype.md): Get details about a given policy type.<br /> <br /> **Permissions required**: Please refer to the main <a href="https://apidocs.hibob.com/reference/time-off#required-permissions">Time off API…
  - [Get all policy types names.](https://apidocs.hibob.com/reference/get_timeoff-policy-types.md): Get a list of all policy type names.<br /> <br /> **Permissions required**: Please refer to the main <a href="https://apidocs.hibob.com/reference/time-off#required-permissions">Time off API Required…
  - [Get Policy details.](https://apidocs.hibob.com/reference/get_timeoff-policies.md): 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…
  - [Get a list of policy names for a given policy type.](https://apidocs.hibob.com/reference/get_timeoff-policies-names.md): Get a list of policy names for the user's defined policy type.<br /> <br /> **Permissions required**: Please refer to the main <a…
- [Calendar events](https://apidocs.hibob.com/reference/calendar-events.md)
  - [Search calendar events](https://apidocs.hibob.com/reference/post_timeoff-calendars-events-search.md): Read company-wide holidays and closures for a date range. Use with Search employee calendars to resolve which calendar applies to each employee before fetching events.
  - [Search Employee Calendars](https://apidocs.hibob.com/reference/post_timeoff-calendars-employees-search.md): Resolves which holiday calendar applies to each employee in a single bulk call.  Each employee's effective calendar is computed server-side using the canonical resolution rule (matches Bob's product…
- [Time off Webhooks](https://apidocs.hibob.com/reference/time-off-webhooks.md): Receive notifications about Time off requests
  - [Time off request requested](https://apidocs.hibob.com/reference/post_webhook_timeoff-request-requested.md): Triggered when submitting a time off request.  Use the **getApi** URL in the payload to retrieve the full request details. When using the getApi URL immediately after this event, the status in the…
  - [Time off request approved](https://apidocs.hibob.com/reference/post_webhook_timeoff-request-approved.md): Triggered when approving a time off request.  For auto-approved requests, two events are sent in sequence: **requested** then **approved**.  In the right panel, open **Examples** and select **Payload…
  - [Time off request declined](https://apidocs.hibob.com/reference/post_webhook_timeoff-request-declined.md): Triggered when declining a time off request.  When using the **getApi** URL to retrieve details of a declined request, the status in the response will be **disapproved** (not "declined").  In the…
  - [Time off request cancelled](https://apidocs.hibob.com/reference/post_webhook_timeoff-request-cancelled.md): Triggered when cancelling a time off request.  In the right panel, open **Examples** and select **Payload Example** to see a real payload.
  - [Time off request deleted](https://apidocs.hibob.com/reference/post_webhook_timeoff-request-deleted.md): Triggered when deleting a time off request.  In the right panel, open **Examples** and select **Payload Example** to see a real payload.
  - [Time off request updated](https://apidocs.hibob.com/reference/post_webhook_timeoff-request-updated.md): Triggered when updating a time off request.  For date or time changes (hard-update), a new request replaces the existing one. The payload then includes **originalRequestId** (the very first request…
  - [Time off request created from import](https://apidocs.hibob.com/reference/post_webhook_timeoff-request-imported.md): Triggered when importing a time off request.  Imported requests are always approved by default. When using the **getApi** URL immediately after this event, the status in the response will be…
  - [Set end date to a time off request](https://apidocs.hibob.com/reference/post_webhook_timeoff-request-set-end-date.md): Triggered when setting the end date of an open-ended time off request.  In the right panel, open **Examples** and select **Payload Example** to see a real payload.