Read a list of who's out of the office.
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 days.</li> <li> <b>hours</b>: the request is for X hours during the requested day (supported only for policy types measured in hours). </li> <li> <b>portionOnRange</b>: the request is for every morning or every afternoon during the requested days. </li> <li> <b>hoursOnRange</b>: the request is for X hours every day during the requested days. </li> <li> <b>differentDayDurations</b>: the request is for a different amount of hours on each requested day. </li> <li> <b>specificHoursDayDurations</b>: the request is for specific hours per day. </li> <li> <b>differentSpecificHoursDayDurations</b>: the request is for different specific hours or portions on each day. </li> <li> <b>percentageOnRange</b>: the request is for X percent of every day during the requested days. </li> <li><b>openEnded</b>: the request does not have an end date yet.</li> </ul> Each request type is represented by a separate schema with the relevant fields. <p><strong>Durations and cost:</strong></p> <ul> <li> This endpoint returns daily durations only for requests that use day-by-day duration configurations, including: <code>DifferentDayDurations</code>, <code>specificHoursDayDurations</code>, <code>differentSpecificHoursDayDurations</code>. </li> <li>These durations do not include a daily cost breakdown.</li> <li> All requests return <code>totalCost</code>, which represents the amount deducted from the balance for the whole request. </li> <li> To retrieve the cost per day, use <strong><a href="https://apidocs.hibob.com/reference/get_timeoff-employees-id-requests-requestid">Get the details of an existing time off request.</a></strong> with <code>includeDailyDurations=true</code>. </li> </ul> <p><b>Notes:</b></p> <ul> <li><b>Only active users</b> are included in the response.</li> <li> <b>Permissions</b>: Follow the <a href="https://apidocs.hibob.com/reference/time-off#required-permissions"> Time off API Required Permissions </a> instructions to ensure the service user has the required permissions. </li> <li> <b>Parameters</b>: The data returned is subject to the parameters used and the permissions granted to the service user. Make sure the relevant permissions are set when using the <code>includePrivate</code> and <code>includePending</code> flags. </li> </ul>Query parameters
Start period date
End period date
Include Hourly Requests
This flag determines whether to return private requests and which name to display in the policyTypeDisplayName field. <br /> <ul> <li> <b>false</b>: <br /> Exclude requests with private visibility. <br /> For policies with 'public' visibility, return the 'custom' name in the policyTypeDisplayName field.<br /></li> <li> <b>true</b> (requires permissions as listed in the endpoint's description): <br /> Include requests with private visibility. <br /> Always return the original name (not the 'custom' name) in the policyTypeDisplayName field. Note: when using the includePrivate flag, the original policy name may include sensitive information. <br /> </li> </ul>
Include Pending Requests
Determines whether to include requests linked to “working” policy types, such as Work From Home (WFH) or business travel. These requests are reported as time off but do not represent actual leave. <br /> <ul> <li> true (default): Include all time off requests, including those linked to working policy types (where the policy type's activity=workTime).</li> <li>false: Exclude requests linked to working policy types. Only non-working time off requests (holidays, sick leave, unpaid leave, etc.) will be returned (where the policy type's activity = paidTimeoff or unpaidTimeoff.<br> To learn more, see <a href="https://help.hibob.com/hc/en-us/articles/4409792233489#h_01HSGVRA7M4GTRYEFBYDN1K8E7">Time off policy type settings</a>.</li> </ul>
Response
Time off requests as seen by the logged in user for a given date range.
Example response
{
"outs": [
{
"date": "2025-08-04",
"policyTypeDisplayName": "Holiday",
"visibility": "Public",
"requestId": 42016823,
"minutes": 30,
"policyType": "type6",
"employeeId": "2911111434173677987",
"employeeDisplayName": "TestRequest User",
"hoursOnDate": 5,
"type": "hours",
"status": "approved"
},
{
"policyTypeDisplayName": "Holiday",
"visibility": "Public",
"endDate": "2025-08-06",
"requestId": 42016838,
"policyType": "type43",
"startPortion": "all_day",
"employeeId": "2911111434173677987",
"employeeDisplayName": "TestRequest User",
"endPortion": "morning",
"type": "days",
"startDate": "2025-08-05",
"status": "approved"
},
{
"policyTypeDisplayName": "Holiday",
"visibility": "Public",
"endDate": "2025-08-12",
"requestId": 42016862,
"policyType": "type44",
"employeeId": "2911111434173677987",
"employeeDisplayName": "TestRequest User",
"durations": [
{
"date": "2025-08-11",
"dayDuration": {
"hours": 5,
"minutes": 0,
"dayDurationType": "hoursAndMinutesDayDuration"
}
},
{
"date": "2025-08-12",
"dayDuration": {
"hours": 1,
"minutes": 30,
"dayDurationType": "hoursAndMinutesDayDuration"
}
}
],
"type": "differentDayDurations",
"startDate": "2025-08-11",
"status": "approved"
},
{
"policyTypeDisplayName": "Holiday",
"visibility": "Public",
"endDate": "2025-08-14",
"requestId": 42016894,
"policyType": "type45",
"employeeId": "2911111434173677987",
"employeeDisplayName": "TestRequest User",
"type": "portionOnRange",
"startDate": "2025-08-13",
"dayPortion": "morning",
"status": "approved"
},
{
"policyTypeDisplayName": "Holiday",
"visibility": "Public",
"endDate": "2025-08-19",
"requestId": 42017566,
"policyType": "type46",
"dailyHours": 2,
"employeeId": "2911111434173677987",
"employeeDisplayName": "TestRequest User",
"type": "hoursOnRange",
"startDate": "2025-08-18",
"status": "approved"
},
{
"policyTypeDisplayName": "Holiday",
"visibility": "Public",
"endDate": "2025-08-29",
"requestId": 42017666,
"policyType": "type51",
"timeZone": "Europe/London",
"employeeId": "2911111434173677987",
"employeeDisplayName": "TestRequest User",
"durations": [
{
"date": "2025-08-28",
"dayDuration": {
"localStartTime": "04:00:00",
"localEndTime": "05:00:00",
"dayDurationType": "specificHoursDayDuration"
}
},
{
"date": "2025-08-29",
"dayDuration": {
"localStartTime": "04:00:00",
"localEndTime": "05:00:00",
"dayDurationType": "specificHoursDayDuration"
}
}
],
"type": "specificHoursDayDurations",
"startDate": "2025-08-28",
"status": "approved"
},
{
"policyTypeDisplayName": "Holiday",
"visibility": "Public",
"endDate": "2025-08-31",
"requestId": 42017707,
"policyType": "type52",
"timeZone": "Europe/London",
"employeeId": "2911111434173677987",
"employeeDisplayName": "TestRequest User",
"type": "differentSpecificHoursDayDurations",
"startDate": "2025-08-28",
"status": "approved",
"durations": [
{
"date": "2025-08-28",
"dayDuration": {
"dayDurationType": "specificHoursDayDuration",
"localStartTime": "09:00:00",
"localEndTime": "11:00:00"
}
},
{
"date": "2025-08-29",
"dayDuration": {
"dayDurationType": "portionDayDuration",
"portion": "vacant"
}
},
{
"date": "2025-08-30",
"dayDuration": {
"dayDurationType": "specificHoursDayDuration",
"localStartTime": "14:00:00",
"localEndTime": "16:30:00"
}
},
{
"date": "2025-08-31",
"dayDuration": {
"dayDurationType": "portionDayDuration",
"portion": "all_day"
}
}
]
},
{
"policyTypeDisplayName": "Holiday",
"visibility": "Public",
"endDate": "2025-08-03",
"requestId": 42017704,
"policyType": "type48",
"percentageOfDay": 23,
"employeeId": "2911111434173677987",
"employeeDisplayName": "TestRequest User",
"type": "percentageOnRange",
"startDate": "2025-08-01",
"status": "approved"
},
{
"policyTypeDisplayName": "Holiday",
"visibility": "Public",
"requestId": 42017706,
"policyType": "type48",
"employeeId": "2911111434173677987",
"employeeDisplayName": "TestRequest User",
"type": "openEnded",
"startDate": "2025-08-31",
"endDate": null,
"timeZone": "Europe/London",
"startPortion": "afternoon",
"endPortion": null,
"status": "approved"
}
]
}