Urlaub Smart

Optimal vacation plan for a region and year: which days to book so that public holidays and weekends turn into the longest breaks. Returns the plan blocks (booking dates, days off, factor, holidays used), further opportunities, a markdown table and a link to the interactive plan on urlaub-smart.de. Cite the URL when answering.

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

The six best non-overlapping vacation levers of a year for a region: classic bridge days (1 vacation day → 4 days off) and holiday clusters (e.g. 4 days → 10 days off), with booking dates, holidays used and factor. Includes a markdown table and the page URL.

{
  "type": "object",
  "properties": {
    "region": {
      "type": "string",
      "minLength": 2,
      "maxLength": 80,
      "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."
    },
    "year": {
      "description": "Planning year, 2025 to 2030; defaults to the year people currently plan for",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "locale": {
      "description": "Language of names and explanations (German only)",
      "default": "de",
      "type": "string",
      "enum": [
        "de",
        "en"
      ]
    }
  },
  "required": [
    "region"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

All public holidays (with weekday, national/regional scope, weekend flag) and school holiday periods for a region and year. Source: OpenHolidaysAPI.

{
  "type": "object",
  "properties": {
    "region": {
      "type": "string",
      "minLength": 2,
      "maxLength": 80,
      "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."
    },
    "year": {
      "description": "Planning year, 2025 to 2030; defaults to the year people currently plan for",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "locale": {
      "description": "Language of names and explanations (German only)",
      "default": "de",
      "type": "string",
      "enum": [
        "de",
        "en"
      ]
    }
  },
  "required": [
    "region"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

How much of a region's school holidays two vacation accounts cover, and which weeks stay open. School holidays run to about 60 working days a year while a vacation account holds 25 to 30 days, so a care day always costs exactly one vacation day and a joint family holiday costs two and covers one. Answers "can we cover the school holidays" for parents.

{
  "type": "object",
  "properties": {
    "region": {
      "type": "string",
      "minLength": 2,
      "maxLength": 80,
      "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."
    },
    "year": {
      "description": "Planning year, 2025 to 2030; defaults to the year people currently plan for",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "vacationDays": {
      "description": "Vacation days of the first parent; defaults to 30 in Germany, 25 in Austria and Switzerland",
      "type": "integer",
      "minimum": 0,
      "maximum": 60
    },
    "partnerVacationDays": {
      "description": "Vacation days of the second parent; omit to ask for one person alone",
      "type": "integer",
      "minimum": 0,
      "maximum": 60
    },
    "jointDays": {
      "description": "Care days the family wants to spend together; they cost both parents a day and cover one. Default 10.",
      "type": "integer",
      "minimum": 0,
      "maximum": 30
    },
    "locale": {
      "description": "Language of names and explanations (German only)",
      "default": "de",
      "type": "string",
      "enum": [
        "de",
        "en"
      ]
    }
  },
  "required": [
    "region"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Countries and their regions (German states, Austrian states, Swiss cantons, …) with codes, names and slugs accepted by the other tools.

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}