Input schema (JSON)
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"region"
],
"properties": {
"year": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Planning year, 2025 to 2030; defaults to the year people currently plan for"
},
"shift": {
"type": "object",
"required": [
"onDays",
"offDays",
"firstWorkingDay"
],
"properties": {
"onDays": {
"type": "integer",
"maximum": 14,
"minimum": 1
},
"offDays": {
"type": "integer",
"maximum": 14,
"minimum": 1
},
"firstWorkingDay": {
"type": "string",
"maxLength": 10,
"description": "ISO date of the first working day of a cycle"
}
},
"description": "Rolling shift rotation instead of Mon–Fri, e.g. 4 days on / 2 days off. Replaces the weekday assumption entirely."
},
"locale": {
"enum": [
"de",
"en"
],
"type": "string",
"default": "de",
"description": "Language of names and explanations (German only)"
},
"region": {
"type": "string",
"maxLength": 80,
"minLength": 2,
"description": "Region as name, slug or ISO code, e.g. \"Bayern\", \"bavaria\", \"DE-BY\", \"Tirol\", \"Zürich\" or a country like \"Deutschland\" / \"AT\". Germany, Austria and Switzerland only."
},
"strategy": {
"enum": [
"balanced",
"long-weekends",
"extended"
],
"type": "string",
"default": "balanced",
"description": "balanced = mix, long-weekends = max 2 vacation days per block, extended = blocks of 4+ days"
},
"fixedDates": {
"type": "array",
"items": {
"type": "string",
"maxLength": 10
},
"maxItems": 60,
"description": "ISO dates already booked as vacation; the plan works around them"
},
"vacationDays": {
"type": "integer",
"maximum": 60,
"minimum": 0,
"description": "Vacation days available for the year; defaults to the usual account of the country: 30 in Germany, 25 in Austria and Switzerland"
},
"carryoverDays": {
"type": "integer",
"maximum": 60,
"minimum": 0,
"description": "Part of vacationDays that is carry-over from last year and expires on March 31; spent first on periods before the deadline"
},
"closuresOnTop": {
"type": "boolean",
"description": "Set true only if the employer gives the closures on top of the vacation days; then they are treated like public holidays"
},
"schoolHolidays": {
"enum": [
"any",
"avoid",
"prefer"
],
"type": "string",
"default": "any",
"description": "any = ignore, avoid = no overlap with school holidays, prefer = book only inside school holidays"
},
"companyClosures": {
"type": "array",
"items": {
"type": "object",
"required": [
"from",
"to"
],
"properties": {
"to": {
"type": "string",
"maxLength": 10
},
"from": {
"type": "string",
"maxLength": 10
}
}
},
"maxItems": 12,
"description": "Company closures (Betriebsferien) as inclusive ISO date ranges. By default their working days come off vacationDays, as Betriebsferien are normally scheduled annual leave"
},
"companyFreeDates": {
"type": "array",
"items": {
"type": "string",
"maxLength": 10
},
"maxItems": 60,
"description": "Working days the employer gives off without a vacation day, ISO dates (e.g. 2027-12-24, 2027-12-31); treated like public holidays"
}
}
}