One absence (own, or any with hr:absence:approve)
GET /api/hr/v1/absences/{id}
Module: HR · operationId: getAbsence · Tag: Absences · Auth: access token (Authorization: Bearer <accessToken>)
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
id |
path | string (uuid) | yes |
Responses
- 200 Absence (
application/json) - 404 Error (
application/json)
Fields of the 200 answer:
createdAt(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)
Example 200 answer:
{
"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
}
Example request
curl -X GET 'https://api.mbcom.cloud/api/hr/v1/absences/3f2b8c1e-7d4a-4e9b-9c2a-5b1d6e8f0a12' \
-H "Authorization: Bearer $ACCESS_TOKEN"