Skip to content
HALOWERK

Rechenwerk

school holidays

Pinned independent extraction of the Bavarian ministerial Ferienordnung and NRW Runderlass, checked against current consolidation and official NRW calendar files. DE-BY and DE-NW only. Preserves source labels and full original periods, one-day Pfingsten and explicit no-break statements; movable-day budgets and approved school exceptions are separate. No nationwide or individual-school calendar claim.

POST https://rechen.halowerk.com/v1/school-holidays

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
stateSee schemaYesVerified state ISO 3166-2 code; only DE-BY and DE-NW.
yearintegerYesCalendar year; original Christmas periods may extend outside it.
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "state",
    "year"
  ],
  "properties": {
    "state": {
      "enum": [
        "DE-BY",
        "DE-NW"
      ],
      "description": "Verified state ISO 3166-2 code; only DE-BY and DE-NW."
    },
    "year": {
      "type": "integer",
      "minimum": 2025,
      "maximum": 2029,
      "description": "Calendar year; original Christmas periods may extend outside it."
    }
  }
}

Open original schema

Published input example

{
  "state": "DE-NW",
  "year": 2027
}

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 →