Für Entwickler

Die Holiday API liefert Schweizer Feiertage für den Bund und alle 26 Kantone als JSON und iCalendar – aus Regeln berechnet, für jedes Jahr von 1583 bis 9999, auf Deutsch, Französisch, Italienisch und Englisch.

Interaktive API-Dokumentation öffnen

Beispiele

Alle Feiertage eines Kantons in einem Jahr

curl "https://holiday.test.geek.ch/api/v1/holidays?region=CH-VS&year=2027"

Ist ein Datum ein Feiertag?

curl "https://holiday.test.geek.ch/api/v1/holidays/check?region=CH-BE&date=2027-08-01"

Datum plus zehn Arbeitstage

curl "https://holiday.test.geek.ch/api/v1/workdays/add?region=CH-ZH&date=2027-12-20&days=10"

Kalender-Abo (iCalendar)

https://holiday.test.geek.ch/api/v1/calendars/CH-VS.ics

Nutzung und Limits

Die API ist ohne Anmeldung nutzbar, mit einem Limit pro IP-Adresse. Wer mehr braucht, erhält auf Anfrage einen API-Schlüssel mit höherem Limit; eine Selbstregistrierung gibt es nicht.