ConnectCloud Developers

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 calendar
    • id (string): Id of the employee
    • name (string): Display name of the employee
  • entries (array of object): Absences in the range
    • employeeId (string): Id of the employee
    • employeeName (string): Display name of the employee
    • endDate (string (date)): Last day (YYYY-MM-DD), inclusive
    • endHalf (boolean): The last day is only the morning
    • id (string): Empty for colleagues' absences
    • startDate (string (date)): First day (YYYY-MM-DD)
    • startHalf (boolean): The first day is only the afternoon
    • status (string): State of the absence
    • typeId (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 range
    • 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 of 0.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"

View as Markdown · Interactive reference · OpenAPI