---
title: "GET /v4/absences"
method: GET
path: "/v4/absences"
tags: ["Absence"]
---

# GET /v4/absences

`GET /v4/absences`

## Query parameters

- `filter` object
  - `status` union
    - AbsenceStatus[]
    - 0 | 1 | 2 | 3 | 4 — Possible values: - `0`: Enquired - `1`: Approved - `2`: Declined - `3`: ApprovalCancelled - `4`: Cancelled
    - string, csv-string
  - `teams_id` union
    - integer[]
    - string, csv-string
  - `type` union
    - AbsenceType[]
    - 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 — Possible values: - `1`: Holiday from the quota - `2`: Special leaves - `3`: Reduction of overtime - `4`: Sick day - `5`: Sick day of a child - `6`: School / further education - `7`: Maternity protection - `8`: Home office (planned hours get applied) - `9`: Work out of office (planned hours get applied) - `10`: Special leaves (unpaid) - `11`: Sick day (unpaid) - `12`: Sick day of a child (unpaid) - `13`: Quarantine (work not possible) - `14`: Military / alternative service - `15`: Sick day (sickness benefit)
    - string, csv-string
  - `users_active` boolean
  - `users_id` union
    - integer[]
    - integer
    - string, csv-string
  - `year` union
    - integer[]
    - integer
    - string, csv-string
- `scope` 'manageableAbsences' | 'viewableAbsences' — Possible values: - `manageableAbsences`: ManageableAbsences - `viewableAbsences`: ViewableAbsences

## Response `200`

Successful operation

- object
  - `data` AbsenceV4[], required
    - union
      - AbsenceHourAbsenceV4
        - `id` integer, required
        - `users_id` integer, required
        - `date_since` string, date, required
        - `date_until` string, date, required
        - `type` 3 — Possible values: - `3`: Reduction of overtime
        - `status` 0 | 1 | 2 | 3 | 4, required — Possible values: - `0`: Enquired - `1`: Approved - `2`: Declined - `3`: ApprovalCancelled - `4`: Cancelled
        - `note` string, nullable — Only with access rights for absence administration or in case of own absences
        - `public_note` string, nullable, required
        - `sick_note` boolean, nullable — Only with access rights for absence administration or in case of own absences. Only for types 4 (SickSelf) and 5 (SickChild). Null in case of other absences.
        - `count_days` number, float, required — Null in case of overtime reduction.
        - `count_hours` number, float — Only with access rights for absence administration or in case of own absences. Null in case of other absences.
        - `date_enquired` string, date, nullable — Only with access rights for absence administration or in case of own absences
        - `date_approved` string, date, nullable — Only with access rights for absence administration or in case of own absences
        - `approved_by` integer, nullable — Only with access rights for absence administration or in case of own absences
      - AbsenceDayAbsenceV4
        - `id` integer, required
        - `users_id` integer, required
        - `date_since` string, date, required
        - `date_until` string, date, required
        - `type` 1 | 2 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 — Possible values: - `1`: Holiday from the quota - `2`: Special leaves - `4`: Sick day - `5`: Sick day of a child - `6`: School / further education - `7`: Maternity protection - `8`: Home office (planned hours get applied) - `9`: Work out of office (planned hours get applied) - `10`: Special leaves (unpaid) - `11`: Sick day (unpaid) - `12`: Sick day of a child (unpaid) - `13`: Quarantine (work not possible) - `14`: Military / alternative service - `15`: Sick day (sickness benefit)
        - `status` 0 | 1 | 2 | 3 | 4, required — Possible values: - `0`: Enquired - `1`: Approved - `2`: Declined - `3`: ApprovalCancelled - `4`: Cancelled
        - `note` string, nullable — Only with access rights for absence administration or in case of own absences
        - `public_note` string, nullable, required
        - `sick_note` boolean, nullable — Only with access rights for absence administration or in case of own absences. Only for types 4 (SickSelf) and 5 (SickChild). Null in case of other absences.
        - `count_days` number, float, required — Null in case of overtime reduction.
        - `count_hours` unknown
        - `date_enquired` string, date, nullable — Only with access rights for absence administration or in case of own absences
        - `date_approved` string, date, nullable — Only with access rights for absence administration or in case of own absences
        - `approved_by` integer, nullable — Only with access rights for absence administration or in case of own absences

## Other responses

- `400` — Bad request

---

[API](https://skmtc.dev/clockodo/apis/clockodo-api-documentation.md) · [All operations](https://skmtc.dev/clockodo/apis/clockodo-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/clockodo/clockodo-api-documentation/revisions/38e281d50d6d/schema)