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-entitlementInputs
| Field | Type | Required | Description |
|---|---|---|---|
| year | integer | Yes | |
| days_per_week | number | Yes | Working days per week at the start of the year (or of the employment). |
| schedule_changes | array | No | Changes of the number of working days per week within the year. |
| contract_days_per_year | number | No | Contractual or collective annual leave in days. |
| contract_basis_days_per_week | number | No | Weekly working days the contractual figure refers to. |
| employment_start | string | No | |
| employment_end | string | No | |
| severely_disabled | boolean | No | Severely disabled during the whole year. |
| severely_disabled_from | string | No | Start of the severe disability status, if within the year. |
| birth_date | string | No | For the youth minimum of § 19 JArbSchG. |
| proration | string | No | Weighting 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."
}
}
}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
- Rechenwerk0.003 USDC
ai act risk class
POSThttps://rechen.halowerk.com/v1/ai-act-risk-classEvaluates the caller’s description against Regulation (EU) 2024/1689 as amended by Regulation (EU) 2026/1744: prohibited practices of Art. 5(1)(a)-(h) and the new points (ba) and (bb) (from 2 December 2026); high-risk under Art. 6(1) (safet
- Rechenwerk0.002 USDC
annuity schedule
POSThttps://rechen.halowerk.com/v1/annuity-scheduleMonthly annuity in arrears as used by German banks: rate = loan × (nominal rate + initial repayment rate) / 12, or from a term via A = L·q^n·(q−1)/(q^n−1) with q = 1 + i/12; interest each month = balance × i/12 (30/360), rounded to cents, t
- Rechenwerk0.002 USDC
appeal deadlines
POSThttps://rechen.halowerk.com/v1/appeal-deadlinesCovers only clearly codified periods: Berufung one month and grounds two months (§§ 517, 520(2) ZPO), Revision one and two months (§§ 548, 551(2) ZPO), labour court appeal (§ 66(1) ArbGG), all starting with service of the complete judgment