Offene Feiertagsdaten: JSON und ICS

Adressen (stabil, Version 1)

Alle Dateien sind statisch und werden täglich gecacht. Ländercode = ISO 3166-1 alpha-2 in Kleinbuchstaben, Regionscodes = ISO 3166-2 ohne Länderpräfix.

https://toolboxday.com/data/v1/holidays/index.json
https://toolboxday.com/data/v1/holidays/{country}/{year}.json
https://toolboxday.com/data/v1/holidays/{country}/{year}.ics

index.json · /data/v1/holidays/de/2027.json · /data/v1/holidays/fr/2027.ics

{
  "date": "2027-01-06",
  "id": "heiligeDreiKoenige",
  "name": "Epiphany",
  "localName": "Heilige Drei Könige",
  "nationwide": false,
  "regions": [
    "BW",
    "BY",
    "ST"
  ]
}

Beispiel-Code

JavaScript

const res = await fetch('https://toolboxday.com/data/v1/holidays/de/2027.json');
const data = await res.json();
// nationwide holidays + holidays of one state (e.g. Bavaria = "BY")
const byState = data.holidays.filter(
  (h) => h.nationwide || h.regions?.includes('BY')
);
console.log(byState.map((h) => `${h.date} ${h.name}`));

Python

import json, urllib.request

url = "https://toolboxday.com/data/v1/holidays/de/2027.json"
data = json.load(urllib.request.urlopen(url))
for h in data["holidays"]:
    where = "nationwide" if h["nationwide"] else ", ".join(h["regions"])
    print(h["date"], h["name"], "-", where)

curl + jq

curl -s https://toolboxday.com/data/v1/holidays/de/2027.json | jq '.holidays[] | select(.nationwide) | .date'

Kalender abonnieren

Die ICS-Dateien enthalten die landesweiten Feiertage. In Google Kalender unter „Weitere Kalender → Per URL“ einfügen, in Outlook unter „Kalender hinzufügen → Aus dem Internet“, auf dem iPhone unter „Einstellungen → Kalender → Accounts → Kalenderabo hinzufügen“.

https://toolboxday.com/data/v1/holidays/fr/2027.ics

Wie die Daten geprüft sind

• Deutschland: aus den 16 Landesfeiertagsgesetzen und dem Einigungsvertrag berechnet, automatisch gegen die Gesetzestexte getestet.
• Übrige Länder: erzeugt mit python-holidays, abgeglichen mit Nager.Date und den öffentlichen Feiertagskalendern von Google. Länder, Jahre oder Regionen mit Abweichung sind hier nicht enthalten.
• Feiertage nach dem Mondkalender tragen „estimated“: das Datum kann je nach Mondsichtung um einen Tag abweichen. Keine Gewähr – für rechtsverbindliche Zwecke gilt die amtliche Quelle.

Schulferien

Die JSON-Dateien für Deutschland enthalten zusätzlich die Schulferien aller 16 Bundesländer (Quelle: KMK und Kultusministerien), soweit amtlich veröffentlicht.

Schulferien weiterer Länder (aus der OpenHolidays API) gibt es als eigene Datei unter der Open Database License (ODbL 1.0): /data/schulferien-welt.json

Fehler gefunden oder ein Land fehlt? Schreiben Sie uns: info@saracai.de