ConnectCloud Developers

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 page
    • createdAt (string (date-time)): When the absence was created
    • createdBy (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 last
    • decidedBy (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 employee
    • employeeName (string): Display name of the employee (in lists)
    • endDate (string (date)): Last day (YYYY-MM-DD), inclusive
    • endHalf (boolean): The last day is only the morning
    • id (string): Id of the absence
    • note (string): The employee's note
    • startDate (string (date)): First day (YYYY-MM-DD)
    • startHalf (boolean): The first day is only the afternoon
    • status (string): State of the absence; types without approval start as approved (one of requested, approved, rejected, cancelled, cancellation_requested)
    • typeId (string): Id of the absence type
    • updatedAt (string (date-time)): When the absence was last changed
    • version (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"

View as Markdown · Interactive reference · OpenAPI