Skip to content
HALOWERK

Rechenwerk

vacation entitlement

Converts the statutory minimum of 24 working days (§ 3 BUrlG, six-day week) or the youth minimum of 30/27/25 days by age at the start of the year (§ 19 JArbSchG) and a contractual entitlement to the agreed days per week. Changes of the weekly working days during the year are weighted per period (BAG 9 AZR 406/17: periods with their own weekdays, days already earned are not reduced), either by calendar days or by twelfths of months. Applies the six-month waiting period (§ 4), partial leave of.

POST https://rechen.halowerk.com/v1/vacation-entitlement

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
yearintegerYes
days_per_weeknumberYesWorking days per week at the start of the year (or of the employment).
schedule_changesarrayNoChanges of the number of working days per week within the year.
contract_days_per_yearnumberNoContractual or collective annual leave in days.
contract_basis_days_per_weeknumberNoWeekly working days the contractual figure refers to.
employment_startstringNo
employment_endstringNo
severely_disabledbooleanNoSeverely disabled during the whole year.
severely_disabled_fromstringNoStart of the severe disability status, if within the year.
birth_datestringNoFor the youth minimum of § 19 JArbSchG.
prorationstringNoWeighting of schedule periods.
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "year",
    "days_per_week"
  ],
  "properties": {
    "year": {
      "type": "integer",
      "minimum": 2000,
      "maximum": 2098
    },
    "days_per_week": {
      "type": "number",
      "minimum": 0,
      "maximum": 6,
      "description": "Working days per week at the start of the year (or of the employment)."
    },
    "schedule_changes": {
      "type": "array",
      "maxItems": 12,
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "from",
          "days_per_week"
        ],
        "properties": {
          "from": {
            "type": "string",
            "format": "date"
          },
          "days_per_week": {
            "type": "number",
            "minimum": 0,
            "maximum": 6,
            "description": "0 for unpaid special leave (BAG 9 AZR 406/17)."
          }
        }
      },
      "description": "Changes of the number of working days per week within the year."
    },
    "contract_days_per_year": {
      "type": "number",
      "minimum": 0,
      "maximum": 60,
      "description": "Contractual or collective annual leave in days."
    },
    "contract_basis_days_per_week": {
      "type": "number",
      "minimum": 1,
      "maximum": 6,
      "default": 5,
      "description": "Weekly working days the contractual figure refers to."
    },
    "employment_start": {
      "type": "string",
      "format": "date"
    },
    "employment_end": {
      "type": "string",
      "format": "date"
    },
    "severely_disabled": {
      "type": "boolean",
      "default": false,
      "description": "Severely disabled during the whole year."
    },
    "severely_disabled_from": {
      "type": "string",
      "format": "date",
      "description": "Start of the severe disability status, if within the year."
    },
    "birth_date": {
      "type": "string",
      "format": "date",
      "description": "For the youth minimum of § 19 JArbSchG."
    },
    "proration": {
      "type": "string",
      "enum": [
        "calendar_days",
        "twelfths"
      ],
      "default": "calendar_days",
      "description": "Weighting of schedule periods."
    }
  }
}

Open original schema

Published input example

{
  "year": 2026,
  "days_per_week": 3,
  "contract_days_per_year": 30
}

Result & documentation

Machine-readable documentation of this hub

Source of this page: the published HALOWERK catalog. Updated: 2026-11-17 UTC.

More endpoints in this hub

All endpoints in this hub →