Team calendar (tenant:access)
GET /api/hr/v1/absences/calendar
Module: HR · operationId: getAbsenceCalendar · Tag: Absences · Auth: access token (Authorization: Bearer <accessToken>)
Active employees and their absences in a range of at most 93 days. Without
hr:absence:approve colleagues' absences come without type for sensitive types and only
when approved; with absencesVisibleToColleagues off only the caller is listed.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
from |
query | string (date) | yes | |
to |
query | string (date) | yes | |
groupId |
query | string | ||
orgUnitId |
query | string | Only people of this org unit | |
subUnits |
query | boolean | Include the unit's sub-units | |
team |
query | string | mine = only the people the caller is responsible for (one of mine) |
Responses
- 200 Calendar (
application/json) - 400 Error (
application/json)
Fields of the 200 answer:
employees(array of object): People shown in the calendarid(string): Id of the employeename(string): Display name of the employee
entries(array of object): Absences in the rangeemployeeId(string): Id of the employeeemployeeName(string): Display name of the employeeendDate(string (date)): Last day (YYYY-MM-DD), inclusiveendHalf(boolean): The last day is only the morningid(string): Empty for colleagues' absencesstartDate(string (date)): First day (YYYY-MM-DD)startHalf(boolean): The first day is only the afternoonstatus(string): State of the absencetypeId(string): Empty when the viewer may not see the type
from(string (date)): First day of the range (YYYY-MM-DD)holidays(array of Holiday): Holidays in the rangecustom(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
to(string (date)): Last day of the range (YYYY-MM-DD)
Example 200 answer:
{
"employees": [
{
"id": "c7e9a1b3-5d7f-4b2c-8e4a-6f8b0d2c4e06",
"name": "Elias Gruber"
},
{
"id": "d1f3b5c7-9e1a-4d3f-8b5c-7a9e1f3b5d08",
"name": "Hannah Lehner"
},
{
"id": "e5a1c3d7-2b4f-4c6e-8a0b-1d3f5b7c9e02",
"name": "Sophie Huber"
}
],
"entries": [
{
"employeeId": "e5a1c3d7-2b4f-4c6e-8a0b-1d3f5b7c9e02",
"employeeName": "Sophie Huber",
"endDate": "2026-12-18",
"endHalf": false,
"id": "3e5a7c9e-1a3c-4e5a-8c7e-9a1c3e5a7c31",
"startDate": "2026-12-14",
"startHalf": false,
"status": "requested",
"typeId": "8c0e2a4c-6e8a-4c0e-9a4c-6e8a0c2e4a13"
},
{
"employeeId": "d1f3b5c7-9e1a-4d3f-8b5c-7a9e1f3b5d08",
"employeeName": "Hannah Lehner",
"endDate": "2026-12-04",
"endHalf": false,
"id": "",
"startDate": "2026-12-04",
"startHalf": false,
"status": "approved",
"typeId": ""
}
],
"from": "2026-12-14",
"holidays": [
{
"custom": true,
"date": "2026-12-24",
"fraction": 0.5,
"name": "Heiligabend (halber Tag)"
},
{
"custom": false,
"date": "2026-12-25",
"fraction": 1,
"name": "1. Weihnachtstag"
},
{
"custom": false,
"date": "2026-12-26",
"fraction": 1,
"name": "2. Weihnachtstag"
}
],
"to": "2026-12-27"
}
Example request
curl -X GET 'https://api.mbcom.cloud/api/hr/v1/absences/calendar?from=2026-03-02&to=2026-03-02' \
-H "Authorization: Bearer $ACCESS_TOKEN"