## 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:

```json
{
  "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

```bash
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"
```
