Deutsche Feiertage API
Feiertage API
Über die Feiertage API können die Feiertage Daten von sgs-visual auf einfache Weise abgefragt werden, um sie z.B. auf einer externen Webseite oder in einer mobilen App zu nutzen.
Die Daten sind über HTTP-URLs adressierbar. Das Ergebnis wird in JSON-Notation erzeugt.
Die API stellt Feiertagsdaten für Deutschland basierend auf einer JSON-Datei bereit. Die Daten umfassen die Jahre 2025 bis 2045 und enthalten Informationen zu festen beweglichen Feiertagen, deren Datum und in welchen Bundesländern sie gelten, sowie sonstige Tage wie z.B. Valentinstag, Muttertag, Halloween, Nikolaustag... .
Endpunkte und Parameter
1. Liste aller Bundesländer (Schreibweise aus der Datenquelle)
Parameter: list=states
Beschreibung: Gibt eine alphabetisch sortierte Liste aller Bundesländer aus der Datenquelle zurück.
2. Liste aller Feiertagsnamen (Schreibweise aus der Datenquelle)
Parameter: list=holidays
Beschreibung: Gibt eine alphabetisch sortierte Liste aller Feiertagsnamen aus der Datenquelle zurück.
3. Gesamte Daten aus der Datenquelle abrufen
Beschreibung: Gibt die vollständigen Feiertagsdaten für alle Jahre und Bundesländer zurück.
4. Feiertage für ein bestimmtes Jahr aus der Datenquelle abrufen
Parameter: year
Beschreibung: Gibt alle Feiertage für das angegebene Jahr zurück.
5. Feiertage für ein bestimmtes Bundesland aus der Datenquelle abrufen
Parameter: state
Beschreibung: Gibt alle Feiertage für das angegebene Bundesland über alle Jahre zurück.
6. Feiertage für ein bestimmtes Jahr und Bundesland aus der Datenquelle abrufen
Parameter: year und state
Beschreibung: Gibt die Feiertage für das angegebene Jahr und Bundesland zurück.
7. Bundesländer anzeigen, in denen ein bestimmter Feiertag gilt
Parameter: holiday
Beschreibung: Gibt eine Liste der Bundesländer zurück, in denen der angegebene Feiertag gilt.
8. Sonstige Tage:
Parameter: other_days
Gibt die sonstigen Tage für die Jahre von 2025-2045 aus.
Gibt die sonstigen Tage für das Jahr 2026 aus.
Hinweise:
Die Parameter state, holiday oder other_days müssen exakt in der Schreibweise verwendet werden, wie sie in den Listen unter list=states bzw. list=holidays ausgegeben werden.
Der Parameter year muss eine Jahreszahl zwischen 2025 und 2045 sein.
Wenn keine Parameter angegeben sind, liefert die API den vollständigen Datensatz zurück.
Bei ungültigen oder nicht gefundenen Parametern gibt die API eine Fehlermeldung im JSON-Format zurück.
Diese API ermöglicht eine flexible und gezielte Abfrage von Feiertagsdaten für Deutschland sowie sonstige Tage wie Valentinstag, Muttertag,... 4.Advent , ideal für Anwendungen, die regionale oder jahresspezifische Feiertagsinformationen benötigen.
Erstelldatum: 20.06.2025
Revision 00 vom 20.06.2025 - Seitenerstellung