Feiertage und Schulferien als JSON

Statische Dateien, berechnet aus denselben Regeln wie die Seiten: gesetzliche Feiertage je Gebiet und Jahr mit Brückentagen, eine Datei mit allen Jahren für „ist heute Feiertag“ und die Schulferien der Bundesländer. Ohne Schlüssel, ohne Anmeldung, mit Quellenangabe frei nutzbar.

Adressen

Dateien und Adressen

Datei	Inhalt	Beispiel
`/api/feiertage/{land}/{gebiet}/{jahr}.json`	Alle Feiertage eines Gebiets im Jahr mit Datum, Wochentag, Geltung (gesetzlich, teilweise, halb, üblich), Hinweis, dazu die Brückentage	de/bayern/2026
`/api/feiertage/{land}/{gebiet}.json`	Nur gesetzliche Feiertage, alle Jahre 2025 bis 2035, als Datum → Name	ch/zuerich
`/api/schulferien/{land}/{gebiet}/{jahr}.json`	Schulferien eines Bundeslands oder Kantons im Kalenderjahr (Deutschland 2026, 2027, 2028; Österreich 2026, 2027, 2028, 2029; Schweiz 2026, 2027; Niederlande mit noord, midden, zuid 2026, 2027, 2028)	de/nordrhein-westfalen
`/feiertage/{gebiet}/feiertage.csv`	Für Excel: Feiertage des Vorjahres, des laufenden und des folgenden Jahres, Semikolon-getrennt, UTF-8 mit BOM	bayern
`/api/index.json`	Verzeichnis aller Länder, Gebiete und Muster	index

Für Websites ohne eigenes Skript gibt es die wichtigsten Werte auch als einbettbare Widgets. {land} ist de, at oder ch. {gebiet} ist die Kennung aus dem Verzeichnis (zum Beispiel bayern, wien, zuerich) oder „alle“ für die im ganzen Land geltenden Feiertage.

Verzeichnis

Gebietskennungen

Land

Deutschland (de)

Land

Österreich (at)

Beispiele

Ist heute Feiertag?

Shell mit curl und jq, Bayern:

curl -s https://kalenderblick.de/api/feiertage/de/bayern.json | jq -r --arg d "$(date +%F)" '.feiertage[$d] // "kein Feiertag"'

JavaScript, nächster Feiertag ab heute:

const r = await fetch('https://kalenderblick.de/api/feiertage/at/alle.json').then((x) => x.json());
const heute = new Date().toISOString().slice(0, 10);
const [datum, name] = Object.entries(r.feiertage).find(([d]) => d >= heute);
console.log(name, 'am', datum);

Home Assistant (REST-Sensor), Hamburg:

sensor:
  - platform: rest
    name: Feiertag heute
    resource: https://kalenderblick.de/api/feiertage/de/hamburg.json
    value_template: "{{ value_json.feiertage[now().strftime('%Y-%m-%d')] | default('kein Feiertag') }}"
    scan_interval: 86400

Antwort der Jahresdatei (gekürzt), /api/feiertage/de/bayern/2026.json:

{
  "land": "de", "gebiet": { "id": "bayern", "code": "BY", "name": "Bayern" }, "jahr": 2026,
  "feiertage": [
    { "datum": "2026-01-01", "wochentag": "…", "name": "Neujahr", "geltung": "gesetzlich" },
    { "datum": "2026-08-15", "wochentag": "…", "name": "Mariä Himmelfahrt", "geltung": "teilweise", "hinweis": "In Bayern nur in Gemeinden mit überwiegend katholischer Bevölkerung." }
  ],
  "brueckentage": [ { "feiertag": "Christi Himmelfahrt", "datum": "…", "urlaub": ["…"], "freiVon": "…", "freiBis": "…", "freieTage": 4 } ]
}

Fragen

Häufige Fragen

Darf ich die Daten verwenden?

Ja, kostenlos, auch gewerblich, mit Quellenangabe „kalenderblick.de“. Die Feiertage werden nach den Feiertagsgesetzen berechnet, die Schulferien stammen aus der Übersicht der Kultusministerkonferenz. Keine Gewähr; bei Änderungen durch die Länder wird die Seite aktualisiert.

Gibt es Abfragen mit Parametern, etwa „ist heute Feiertag“?

Nein, alle Dateien sind statisch und werden beim Build erzeugt. Für „ist heute Feiertag“ laden Sie die Datei mit allen Jahren Ihres Gebiets und schlagen das heutige Datum als Schlüssel nach; sie ist klein und lässt sich zwischenspeichern.

Wie aktuell sind die Daten, und wie oft sollte ich abrufen?

Das Feld „stand“ nennt das Build-Datum. Feiertage ändern sich selten, Schulferien ein- bis zweimal im Jahr. Einmal täglich abrufen reicht; die Dateien werden mit Cache-Headern ausgeliefert.