Skip to content
HALOWERK

Rechenwerk

bridge days

Builds the off-day calendar from the chosen working weekdays, the public holidays of the federal state (and optional sub-region) and optional company closure days. Every chain of consecutive off-blocks that can be joined by taking the working days in between is a candidate if it contains at least one holiday on a working day and all vacation days lie in the requested year; candidates are ranked by days off per vacation day. With a vacation budget, weighted interval scheduling (dynamic.

POST https://rechen.halowerk.com/v1/bridge-days

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
yearintegerYesVacation year.
statestringNoFederal state of the workplace whose public holidays apply (e.g. NW, BY, BE). Without state only nationwide holidays are used.
regionstringNoOptional sub-region with extra holidays (requires state): BY A=Augsburg, KATH=predominantly Catholic municipalities, EVANG; SN BZ=Bautzen; TH EIC, UH, WAK.
workdaysarrayNoRegular working weekdays.
extra_days_offarrayNoCompany closure days (e.g. 2026-12-24, 2026-12-31) within the year or three weeks around it.
max_vacation_days_per_windowintegerNoLargest number of vacation days for one window.
vacation_budgetintegerNoIf given, an optimal plan for this many vacation days is computed.
limitintegerNoMaximum number of ranked opportunities returned.
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "year"
  ],
  "properties": {
    "year": {
      "type": "integer",
      "minimum": 1995,
      "maximum": 2098,
      "description": "Vacation year."
    },
    "state": {
      "type": "string",
      "enum": [
        "BB",
        "BE",
        "BW",
        "BY",
        "HB",
        "HE",
        "HH",
        "MV",
        "NI",
        "NW",
        "RP",
        "SH",
        "SL",
        "SN",
        "ST",
        "TH"
      ],
      "description": "Federal state of the workplace whose public holidays apply (e.g. NW, BY, BE). Without state only nationwide holidays are used."
    },
    "region": {
      "type": "string",
      "enum": [
        "A",
        "KATH",
        "EVANG",
        "BZ",
        "EIC",
        "UH",
        "WAK"
      ],
      "description": "Optional sub-region with extra holidays (requires state): BY A=Augsburg, KATH=predominantly Catholic municipalities, EVANG; SN BZ=Bautzen; TH EIC, UH, WAK."
    },
    "workdays": {
      "type": "array",
      "minItems": 1,
      "maxItems": 6,
      "uniqueItems": true,
      "items": {
        "type": "string",
        "enum": [
          "sun",
          "mon",
          "tue",
          "wed",
          "thu",
          "fri",
          "sat"
        ]
      },
      "default": [
        "mon",
        "tue",
        "wed",
        "thu",
        "fri"
      ],
      "description": "Regular working weekdays."
    },
    "extra_days_off": {
      "type": "array",
      "maxItems": 30,
      "uniqueItems": true,
      "items": {
        "type": "string",
        "format": "date"
      },
      "description": "Company closure days (e.g. 2026-12-24, 2026-12-31) within the year or three weeks around it."
    },
    "max_vacation_days_per_window": {
      "type": "integer",
      "minimum": 1,
      "maximum": 10,
      "default": 4,
      "description": "Largest number of vacation days for one window."
    },
    "vacation_budget": {
      "type": "integer",
      "minimum": 1,
      "maximum": 40,
      "description": "If given, an optimal plan for this many vacation days is computed."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 200,
      "default": 50,
      "description": "Maximum number of ranked opportunities returned."
    }
  }
}

Open original schema

Published input example

{
  "year": 2026,
  "state": "NW",
  "max_vacation_days_per_window": 4,
  "vacation_budget": 10
}

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 →