GET /v1/feiertage?jahr=2027&land=BY&brueckentage=true
{ "jahr": 2027, "land": "BY", "feiertage": [{"datum": "2027-01-01", "name": "Neujahr"}, {"datum": "2027-01-06", "name": "Heilige Drei Könige"}], "brueckentage": [{"datum": "2027-05-14", "grund": "Christi Himmelfahrt"}] }
Der Liefertermin steht auf Montag, dem 1. November — in Nordrhein-Westfalen ist das Allerheiligen, und der Fahrer steht vor einer verschlossenen Rampe. Wer Fristen im eigenen System rechnet, pflegt entweder eine Tabelle für 16 Bundesländer von Hand oder merkt den Fehler erst, wenn der Kunde anruft. Und im nächsten Jahr liegt Ostern wieder woanders.
Neun Feiertage gelten überall: Neujahr, Karfreitag, Ostermontag, Tag der Arbeit, Christi Himmelfahrt, Pfingstmontag, Tag der Deutschen Einheit und die beiden Weihnachtsfeiertage. Alles andere entscheidet das Land. Die mittlere Spalte zählt, was die Antwort für dieses Bundesland tatsächlich ausgibt — örtliche Sonderfälle stehen im nächsten Abschnitt.
| Bundesland | Feiertage | zusätzlich zu den neun bundesweiten |
|---|---|---|
| Baden-Württemberg | 12 | Heilige Drei Könige, Fronleichnam, Allerheiligen |
| Bayern | 12 | Heilige Drei Könige, Fronleichnam, Allerheiligen |
| Berlin | 10 | Internationaler Frauentag (8. März) |
| Brandenburg | 10 | Reformationstag |
| Bremen | 10 | Reformationstag |
| Hamburg | 10 | Reformationstag |
| Hessen | 10 | Fronleichnam |
| Mecklenburg-Vorpommern | 11 | Frauentag, Reformationstag |
| Niedersachsen | 10 | Reformationstag |
| Nordrhein-Westfalen | 11 | Fronleichnam, Allerheiligen |
| Rheinland-Pfalz | 11 | Fronleichnam, Allerheiligen |
| Saarland | 12 | Fronleichnam, Mariä Himmelfahrt, Allerheiligen |
| Sachsen | 11 | Reformationstag, Buß- und Bettag |
| Sachsen-Anhalt | 11 | Heilige Drei Könige, Reformationstag |
| Schleswig-Holstein | 10 | Reformationstag |
| Thüringen | 11 | Weltkindertag (20. September), Reformationstag |
Vier der neun bundesweiten Tage hängen am Osterdatum und wandern jedes Jahr mit: Karfreitag zwei Tage vor Ostersonntag, Ostermontag einen danach, Christi Himmelfahrt 39 Tage, Pfingstmontag 50 Tage. Fronleichnam liegt 60 Tage nach Ostern und wandert ebenso, gilt aber nur in sechs Ländern. Ostersonntag selbst kann auf jeden Tag zwischen dem 22. März und dem 25. April fallen — deshalb ist eine von Hand gepflegte Liste immer nur bis zum nächsten Jahreswechsel richtig.
Der Buß- und Bettag wurde 1995 in allen Ländern außer Sachsen als gesetzlicher Feiertag gestrichen, um die neue Pflegeversicherung gegenzufinanzieren. Sachsen hat ihn behalten — dafür tragen Arbeitnehmer dort einen um 0,5 Prozentpunkte höheren Anteil am Pflegebeitrag.
Feiertagsrecht ist Landesrecht, an einigen Stellen sogar Gemeinderecht. Diese Fälle löst keine Abfrage nach Bundesland — auch diese nicht:
Zwei weitere Grenzen: Gerechnet werden die Jahre 1990 bis 2100, darüber hinaus antwortet die API mit invalid_year. Und als Brückentag erkennt sie genau zwei Muster — Feiertag am Donnerstag, dann ist der Freitag Brückentag, und Feiertag am Dienstag, dann der Montag. Längere Fenster über mehrere Feiertage und Wochenenden hinweg rechnet der Brückentage-Planer aus.
Ja. Ostern und alle davon abhängigen Feiertage werden mit der Gaußschen Osterformel exakt berechnet, nicht aus einer gepflegten Liste gelesen. Auch der Buß- und Bettag (Mittwoch vor dem 23. November, nur Sachsen) wird korrekt bestimmt — für jedes beliebige Jahr.
Alle 16, mit ihren jeweiligen Besonderheiten: Fronleichnam nur in BW, BY, HE, NW, RP, SL, Mariä Himmelfahrt im Saarland und in bayerischen Gemeinden, Weltkindertag in Thüringen und so weiter.
Ein Brückentag ist ein einzelner Arbeitstag zwischen einem Feiertag und dem Wochenende — der Klassiker für lange Wochenenden. Die API markiert sie automatisch, mit dem Feiertag als Begründung.
Ja — genau dafür ist sie gebaut: Werktage zählen, Fristen ab einem Startdatum berechnen, unter Berücksichtigung der Feiertage des gewählten Bundeslands und der Wochenenden.
Da fast alle Feiertage berechnet statt gepflegt werden, gibt es kaum Pflegebedarf. Kommt ein neuer gesetzlicher Feiertag dazu (wie zuletzt der Weltkindertag in Thüringen), wird er zentral ergänzt — deine Integration bleibt unverändert.
Aktuell ist alles in der Beta komplett kostenlos — keine Kreditkarte, keine Laufzeit. Nach dem Verkaufsstart beginnen die Tarife bei 4,50 € pro Monat (50.000 Aufrufe) — bewusst rund die Hälfte des üblichen Marktpreises. Wer in der Beta dabei ist, wird vor jeder Umstellung informiert.
E-Mail-Adresse in das Formular auf dieser Seite eintragen — der API-Schlüssel erscheint sofort, ohne Bestätigungs-Wartezeit. Damit hast du 1.000 Aufrufe pro Monat frei. Der Schlüssel wird als Hash gespeichert und nur einmal angezeigt, also direkt sicher ablegen.
E-Mail eintragen, Schlüssel erscheint sofort auf der Seite. Kein Konto, keine Kreditkarte, keine Freischaltung durch uns.
Ein einziger HTTP-Aufruf mit deinem Schlüssel im Kopf — aus jeder Programmiersprache, jedem Framework, jedem Automatisierungswerkzeug.
Du bekommst sauberes JSON oder die fertige Datei zurück. Fehler kommen als klare deutsche Meldung, nicht als Rätsel.
GET /v1/feiertage?jahr=2027&land=BY&brueckentage=true
Wir legen die Preise jetzt schon offen, damit du planen kannst. Beta-Nutzer werden rechtzeitig informiert, bevor sich etwas ändert — niemand wird automatisch in einen bezahlten Tarif überführt.
Alle Preise zuzüglich Umsatzsteuer. Monatlich kündbar, keine Mindestlaufzeit, keine Einrichtungsgebühr.
Verwandt: MwSt-Rechner · CSV ↔ JSON · Markdown → HTML · Textlesbarkeit · Alternative zu Holiday API