Working days, holidays and remaining vacation of a planned absence
GET /api/hr/v1/absences/preview
Module: HR · operationId: previewAbsence · Tag: Absences · Auth: access token (Authorization: Bearer <accessToken>)
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
employeeId |
query | string | ||
typeId |
query | string | yes | |
startDate |
query | string (date) | yes | |
endDate |
query | string (date) | yes | |
startHalf |
query | boolean | ||
endHalf |
query | boolean | ||
except |
query | string | Absence being edited |
Responses
- 200 Preview (
application/json) - 400 Error (
application/json)
Fields of the 200 answer:
days(number): Working days the absence would count (halves allowed)holidays(array of Holiday): Holidays inside the period (not counted)custom(boolean): A holiday of the tenant's own (omitted when false)date(string (date)): Date (YYYY-MM-DD)fraction(number): 1 for a full day, 0.5 for a half day (e.g. 24.12.) (one of0.5,1)name(string): Name of the holiday
overlaps(boolean): The period overlaps another absence of the employeeremaining(number): Vacation left in the start year afterwards (vacation types only)
Example 200 answer:
{
"days": 5,
"holidays": [],
"overlaps": false,
"remaining": 4
}
Example request
curl -X GET 'https://api.mbcom.cloud/api/hr/v1/absences/preview?typeId=string&startDate=2026-03-02&endDate=2026-03-02' \
-H "Authorization: Bearer $ACCESS_TOKEN"