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

# POST /v4/absences

`POST /v4/absences`

## Request body

- object
  - `date_since` string, date, required
  - `date_until` string, date, nullable
  - `type` 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15, required — 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)
  - `half_day` boolean
  - `count_hours` number, float, nullable
  - `users_id` integer
  - `allow_override` integer[] — IDs of absences that may be shortened or deleted to avoid conflicts
  - `status` 0 | 1 | 2 | 3 | 4 — Possible values: - `0`: Enquired - `1`: Approved - `2`: Declined - `3`: ApprovalCancelled - `4`: Cancelled
  - `sick_note` boolean
  - `note` string, nullable
  - `public_note` string, nullable

## Response `200`

Successful operation

- object
  - `data` union, required
    - 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
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `409` — Conflict
- `422` — Unprocessable Entity

---

[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)