Requests

Get all requests

Changed on

Get all requests that overlap the start…end window.

The window between start and end may span at most 1826 days (5 years). Wider ranges are rejected with a 400 response, so page through longer periods in smaller windows.

duration and workday_absence_duration are computed at the time of the call, from the member's current schedule and holiday calendar.

get/requests

Request

  • Base URL
    https://api.absentify.com/api/v1
  • URL
    https://api.absentify.com/api/v1/requests
  • Auth
    API key in header X-API-KEY

Query parameters

startstring required

Date/time in ISO 8601 format, e.g. 2026-06-01 (interpreted as UTC midnight) or 2026-06-01T09:00:00Z. Always include a time zone designator (Z for UTC) when sending a time of day. Localized formats such as 01.06.2026 or 06/01/2026 are misinterpreted and must not be used. The window between start and end may span at most 1826 days (5 years). Wider ranges are rejected with a 400 response, so page through longer periods in smaller windows.

endstring required

Date/time in ISO 8601 format, e.g. 2026-06-01 (interpreted as UTC midnight) or 2026-06-01T09:00:00Z. Always include a time zone designator (Z for UTC) when sending a time of day. Localized formats such as 01.06.2026 or 06/01/2026 are misinterpreted and must not be used. The window between start and end may span at most 1826 days (5 years). Wider ranges are rejected with a 400 response, so page through longer periods in smaller windows.

status'PENDING' | 'APPROVED' | 'DECLINED' | 'CANCELED'
request_member_idsstring
department_idsstring
locale'en' | 'de' | 'fr' | 'hu' | 'it' | 'pl' | 'pt' | 'ru' | 'es' | 'tr' | 'uk'

Response

Successful response

idstring required
createdAtstring required
updatedAtstring required
endstring required
startstring required
start_at'morning' | 'afternoon' required

For day-based leave types: whether the absence starts in the morning (the whole first day counts) or afternoon (only the second half of the first day). Ignored for hour-based leave types.

end_at'lunchtime' | 'end_of_day' required

For day-based leave types: whether the absence ends at lunchtime (only the first half of the last day) or end_of_day (the whole last day counts). Ignored for hour-based leave types.

leave_unit'days' | 'half_days' | 'hours' | 'minutes_30' | 'minutes_15' | 'minutes_10' | 'minutes_5' | 'minutes_1' required

The unit stored on this request. It governs duration and workday_absence_duration: day and half-day units use days; hour and minute units use minutes. It may differ from leave_type.leave_unit after the leave type changes.

revisioninteger required

Counts the versions of the request. Starts at 1 and goes up with every applied change. A pending, declined or withdrawn change does not change it.

last_changed_atstring nullable required

When the request was last changed, or null if it never was.

approval_process'Linear_all_have_to_agree' | 'Linear_one_has_to_agree' | 'Parallel_all_have_to_agree' | 'Parallel_one_has_to_agree' | 'Parallel_first_response_decides' required
needs_approvalboolean nullable required

Whether the request needed approval, as recorded when it was created. When false, the approver rows were approved automatically. Null for requests created before this was recorded.

cancel_reasonstring nullable required
reasonstring nullable required
take_from_allowanceboolean required
workday_absence_durationnumber required

Counted duration, the value absentify shows: the working time the absence takes, based on the work schedule and public holidays, unless the leave type also counts days off or public holidays. Days for day and half-day leave units, minutes for hour and minute units. If the leave type deducts from an allowance, this is the amount the absence takes from it, or for a proposed change, would take once the change applies. Canceled and declined requests keep the value but take nothing from the allowance.

durationnumber required

Calendar duration, including non-working days and non-working time: calendar days for day and half-day leave units, elapsed minutes from start to end for hour and minute units. Use workday_absence_duration for the counted duration.

statusstring required
canceld_datestring nullable required

Changes

    • warning

      added the new Parallel_first_response_decides enum value to the // response property for the response status

    • info

      added the required property // to the response with the status

    • info

      added the required property // to the response with the status

    • breaking

      response property items/anyOf[subschema #1]/pending_change/anyOf[subschema #1]/revision list-of-types was widened by adding types null to media type application/json of response 200