URL generieren
Wählen Sie hier ganz einfach aus für welche Jahre und welche Bundesländer Sie Feiertage abrufen wollen. Anschließend können Sie ganz unten im Generator die angezeigte URL kopieren und für Ihre Anwendung verwenden.
Auswahl Jahre
Auswahl Bundesländer
Bundesweite Feiertage
Kosten
Die Benutzung der Feiertage-API ist dauerhaft kostenlos für private und gewerbliche Zwecke. Der Serverbetrieb und die Arbeit an der Schnittstelle verursachen aber natürlich Kosten, weshalb wir uns über eine kleine Spende als Anerkennung für den Webservice sehr freuen würden.
Funktionsweise
Über die URL https://get.api-feiertage.de können alle verfügbaren Feiertage im JSON-Format abgerufen werden. Mit den folgenden Parametern kann man die Feiertage filtern.
Mögliche Parameter
YEARS: Jahreszahlen mit Komma getrennt. Lässt man den Wert weg, so werden alle Jahre berücksichtigt.
Beispiel: https://get.api-feiertage.de?years=2024,2025
STATES: Bundesländerkürzel (siehe oben) mit Komma getrennt. Lässt man den Wert weg, so werden alle Bundesländer berücksichtigt.
Beispiel: https://get.api-feiertage.de?states=bw,by,th
ALL_STATES: Nur bundesweite Feiertage ausgeben. Wird hier eine 1 oder true gesetzt, so ist die Angabe für den Wert STATES überflüssig.
Beispiel: https://get.api-feiertage.de?all_states=1
Zusätzliche Filtermöglichkeiten (Parameter)
AUGSBURG: Wird der Parameter auf 1 oder true gesetzt, so wird auch das Augsburger Friedensfest ausgegeben, welches nur auf dem Gebiet der schwäbischen Stadt ein Feiertag ist.
KATHOLISCH: Wird der Parameter auf 0 oder false gesetzt, so wird der Feiertag Mariä Himmelfahrt herausgefiltert. Dieser Feiertag gilt nur in Gemeinden mit überwiegend katholischer Bevölkerung.
Durch diese 2 zusätzlichen Parameter kann man, in Kombination mit seinem Bundesland, spezifisch für seinen Ort die Feiertage filtern.
Beispiel: https://get.api-feiertage.de/?states=by&augsburg=1 würde spezifisch für Augsburg die Feiertage liefern.
Rückgabewerte
Die Rückgabe erfolgt im JSON-Format und kann folgende Werte enthalten.
STATE: Mögliche Werte: success, error
ERROR_DESCRIPTION: Im Fehlerfall wird hier eine Beschreibung des Fehlers ausgegeben.
FEIERTAGE: Enthält ein Array mit allen gefundenen Feiertagen. Pro Feiertag erhält man die Werte 'date', 'fname', 'all_states' und die Kürzel der Bundesländer. Die Kürzel der Bundesländer können die Werte '0' und '1' annehmen, was anzeigt ob der jeweilige Feiertag in diesem Bundesland ein gesetztlicher Feiertag ist oder nicht. Wenn 'all_states' den Wert '1' hat, bedeutet das, dass dieser Feiertag bundesweit ein gesetzlicher Feiertag ist.
ADDITIONAL_NOTE: Enthält zusätzliche Informationen und wird z.B. ausgegeben, wenn keine Feiertage für die gewählten Filter gefunden werden konnten.
Kontakt
Für alle Fragen, Wünsche, Anregungen oder Fehlermeldungen wenden Sie sich bitte per E-Mail an info@volkit.de.
Allgemeine Beschreibung / Beispiele
Die Feiertage-API kann kostenlos für private und gewerbliche Zwecke genutzt werden, um Feiertage im JSON-Format bequem in eine App oder andere Anwendungen einzuspielen.
Die Feiertage können für ganz Deutschland aber auch für ein oder mehrere Bundesländer abgerufen werden. Außerdem kann nach Jahreszahlen gefiltert werden. Momentan sind die Jahre 2024, 2025 und 2026 verfügbar.
Beispiel: https://get.api-feiertage.de?years=2024,2025&states=bw,by,nw
Wenn man die API-URL https://get.api-feiertage.de ohne Filter verwendet, werden alle verfügbaren Feiertage zurückgegeben.
Die JSON-Rückgabe enthält pro Feiertag das Datum, den Namen, besondere Hinweise und einen true/false-Wert für jedes Bundesland. Außerdem gibt es noch einen Wert, der anzeigt, ob ein Feiertag ein bundesweiter Feiertag ist.
Die URL https://get.api-feiertage.de?all_states=1 würde z.b. alle verfügbaren bundesweiten Feiertage zurückgeben.
Richtigkeit der Daten / Gewährleistung
Die vorhandenen Daten werden sorgfältig geprüft und eingepflegt. Dennoch können wir nicht für die Richtigkeit der Feiertagdaten garantieren. Des Weiteren übernehmen wir keinerlei Haftung für entstandene Schäden durch Benutzung dieser Schnittstelle. Die API wird auf einem deutschen Server mit einer Verfügbarkeit von mind. 99,9 % gehostet, dennoch kann auch für die Erreichbarkeit der Schnittstelle nicht garantiert werden.