List absences
GET /api/hr/v1/absences
Module: HR · operationId: listAbsences · Tag: Absences · Auth: access token (Authorization: Bearer <accessToken>)
Tenant-wide approvers (hr:absence:approve) see everybody's absences, managers their own and those of the people they are responsible for (chain of command and deputies), everyone else only their own.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
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) |
|
responsible |
query | string | me = requests where the caller should act first (first available manager or their deputy; for tenant-wide approvers also requests nobody else can decide) (one of me) |
|
employeeId |
query | string | ||
status |
query | string | Comma-separated statuses | |
typeId |
query | string | ||
from |
query | string (date) | Absences ending on or after this date | |
to |
query | string (date) | Absences starting on or before this date | |
limit |
query | integer | 1–200; another value is a 400 invalid. (default 50; max 200) |
|
offset |
query | integer | (default 0) |
Responses
- 200 A page of absences, latest first (
application/json) - 400 Error (
application/json)
Fields of the 200 answer:
items(array of Absence): Absences of this pagecreatedAt(string (date-time)): When the absence was createdcreatedBy(string): Who entered the absence (e-mail of the caller; the platform team acting in the tenant: „Plattformbetrieb (MBCOM) · “)days(number): Working days (halves allowed)decidedAt(string (date-time)): When it was decided lastdecidedBy(string): Who decided last (e-mail; the platform team acting in the tenant: „Plattformbetrieb (MBCOM) · “)decisionNote(string): Note of the last decision (e.g. the reason of a rejection)employeeId(string): Id of the employeeemployeeName(string): Display name of the employee (in lists)endDate(string (date)): Last day (YYYY-MM-DD), inclusiveendHalf(boolean): The last day is only the morningid(string): Id of the absencenote(string): The employee's notestartDate(string (date)): First day (YYYY-MM-DD)startHalf(boolean): The first day is only the afternoonstatus(string): State of the absence; types without approval start as approved (one ofrequested,approved,rejected,cancelled,cancellation_requested)typeId(string): Id of the absence typeupdatedAt(string (date-time)): When the absence was last changedversion(integer): Version for optimistic locking: send the version you read with a change (stale: 409 version_conflict)
total(integer): Number of all matching absences
Example 200 answer:
{
"items": [
{
"createdAt": "2026-11-16T08:12:00Z",
"createdBy": "sophie.huber@muster-it.example",
"days": 5,
"employeeId": "e5a1c3d7-2b4f-4c6e-8a0b-1d3f5b7c9e02",
"employeeName": "Sophie Huber",
"endDate": "2026-12-18",
"endHalf": false,
"id": "3e5a7c9e-1a3c-4e5a-8c7e-9a1c3e5a7c31",
"note": "Städtereise Wien",
"startDate": "2026-12-14",
"startHalf": false,
"status": "requested",
"typeId": "8c0e2a4c-6e8a-4c0e-9a4c-6e8a0c2e4a13",
"updatedAt": "2026-11-16T08:12:00Z",
"version": 1
},
{
"createdAt": "2026-09-21T14:40:00Z",
"createdBy": "sophie.huber@muster-it.example",
"days": 3,
"decidedAt": "2026-09-22T10:05:00Z",
"decidedBy": "martin.brandl@muster-it.example",
"employeeId": "e5a1c3d7-2b4f-4c6e-8a0b-1d3f5b7c9e02",
"employeeName": "Sophie Huber",
"endDate": "2026-10-09",
"endHalf": false,
"id": "5a7c9e1a-3c5e-4a7c-9e1a-3c5e7a9c1e32",
"note": "Brückentage",
"startDate": "2026-10-07",
"startHalf": false,
"status": "approved",
"typeId": "8c0e2a4c-6e8a-4c0e-9a4c-6e8a0c2e4a13",
"updatedAt": "2026-09-22T10:05:00Z",
"version": 2
}
],
"total": 2
}
Example request
curl -X GET 'https://api.mbcom.cloud/api/hr/v1/absences' \
-H "Authorization: Bearer $ACCESS_TOKEN"