Holt Feiertage und Schulferien für ein ganzes Jahr, basierend auf `lat` und `lon` (Geokoordinaten).
Ermöglicht Abfragen per Geokoordinaten. Gibt Feiertage und Schulferien der entsprechenden Gemeinde/Region aus. Zur Verbesserung der Treffer in Randgebieten kann zusätzlich ein ISO-Länderkürzel mitgeschickt werden, und/oder die Suchdistanz verändert werden.
Achtung: Die Lokalisierung erfolgt mittels Distanzmessung. In Randgebieten kann die Zuweisung deshalb falsche Resultate liefern.
Öffnet die interaktive API-Dokumentation mit Swagger, in der Sie API-Endpunkte testen und erkunden können.
Zum Abrufen der Daten verwenden Sie folgende URL. Achten Sie bitte auf Gross-Kleinschrift.
https://feiertagskalender.ch/api/Data/LatLon/index.php
Mit den folgenden Variablen können Sie die Abfrage vervollständigen und die API-Ergebnisse steuern.
Parameter | Erläuterung | Beispiele |
---|---|---|
api_key erforderlich |
Ihr API-Schlüssel | api_key=abc-123-def-456 |
lat erforderlich |
Latitude. Geografische Breite | lat=46.9576 |
lon erforderlich |
Longitude. Geografische Länge | lon=7.45134 |
iso | ISO-Landeskürzel, 2-stellig Optionale Zusatzinformation für verbesserte Zuweisung. |
iso=CH |
dist | Maximale Suchdistanz in km ohne Angabe: 100km (= Standard) |
dist=200 |
year oder jahr |
Jahr der gewünschten Daten |
year= 2026 |
class oder klasse |
Umfang der Daten Varianten: |
klasse=5 |
charset | Die gewünschte Codierung der Antwort Varianten: |
charset=iso-8859-1 |
format | Das gewünschte Ausgabeformat Varianten: |
format=xml |
date_format | Das gewünschte Datumsformat für die Antwort. Standard:`Y-m-d` (z.B., 2025-12-31)
Varianten: |
date_format=d.m.Y |
hl | Gewünschte Sprache der Ausgabe Varianten: |
hl=en |
Die Inhalte der API-Antworten ergeben sich aus:
- den von Ihnen abonnierten Daten (Länder, Feiertage, Schulferien, Kalenderjahre)
- den offiziell bekannten Daten der Gesetzgeber
- der Verfügbarkeit aufgrund unserer Recherchen (IST-Situation unserer Datenbank)
Beachten Sie bitte, dass die Ausgabe im CSV-Format abweicht.
Array | Erläuterung | Beispiel | ||||
---|---|---|---|---|---|---|
interface | Version des API | |||||
source: | href | URL zur Datenquelle (Website) | ||||
description | Bezeichnung der Datenquelle | |||||
copyright | href | URL zum Inhaber des Copyrights (Website) | ||||
description | Bezeichnung des Copyright-Inhabers | |||||
apiName | Identifikation des API | Data/LatLon | ||||
apiStatus | description | Bezeichnung des API-Status. Für Varianten, siehe unter Fehlermeldungen | active | |||
date | Datum des Datenexports | 01.05.2025 | ||||
request: | lat | Latitude. Geografische Breite | 46.9576 | |||
lon | Longitude. Geografische Länge | 7.45134 | ||||
iso | ISO-Landeskürzel, 2-stellig | CH | ||||
dist | Maximale Suchdistanz in km | 100 | ||||
year | Jahr der Daten in der Ausgabe | 2015 | ||||
class | Klasse der Abfrage (betrifft den Umfang der Daten) | 4 | ||||
charset | Schriftcodierung der Ausgabe | utf-8 | ||||
format | Datenformat der Ausgabe | json | ||||
date_format | Datumformat der Ausgabe | d.m.Y | ||||
hl | Sprache der Ausgabe, gemäss Anfrage | de | ||||
results | status | description | Status der Ausgabe. Für Varianten, siehe unter Fehlermeldungen | ok | ||
location | description | Bezeichnung der geografischen Einheit | Bern | |||
type | Bezeichnung der Art der geografischen Einheit | Stadt | ||||
geoId | Geo-ID der geografischen Einheit. | 410 | ||||
iso | ISO-Landeskürzel, 2-stellig | BE | ||||
iso-3166-2 | Regionencode nach ISO 3166-2 | |||||
note | Besondere Hinweise | |||||
events | Die Kalenderevents | |||||
description | Bezeichnung des Feiertags, oder der Schulferien | Neujahr | ||||
id | Eindeutige ID des Events. Feiertage haben jedes Jahr dieselbe ID. Schulferien haben alle ihre eigenen IDs. |
1 | ||||
dateStart | Datum Beginn des Events | 01.01.2015 | ||||
dateEnd | Datum Ende des Events | 01.01.2015 | ||||
class | Klasse des Events: 0 = Schulferien 1 = gesetzlich anerkannter Feiertag 2 = Den Sonntagen gleichgestellter Feiertag 3 = halber, gesetzlich anerkannter Feiertag (meist ab Mittag) 4 = gesetzlich nicht anerkannter Feiertag (Geschäfte, Schulen, Verwaltungen meist geschlossen), Bankenfeiertag; im Sinne des Europäischen Übereinkommens über die Berechnung der Fristen wird dieser Tag wie ein gesetzlicher Feiertag behandelt (Art. 5). 5 = Ereignistag # = nur teilweise gültig |
2 | ||||
percent | Umfang der betroffenen Einwohner / Schulklassen in Prozent | 100 | ||||
prov | Flag für provisorisch festgelegte Daten 0 = definitiv 1 = provisorisch |
0 | ||||
note | besondere hinweise |
URL:
https://www.feiertagskalender.ch/api/Data/LatLon/index.php?api_key=YOUR_API_KEY&lat=46.9488&lon=7.4388&year=2022
Antwort des APIs:
{ "interface": "fcal API 2.02", "source": { "href": "https://feiertagskalender.ch", "description": "feiertagskalender.ch" }, "copyright": { "href": "https://psc.ch", "description": "psc Peter Schuetz Informatik-Dienstleistungen, CH Arch" }, "apiName": "Data/LatLon", "apiStatus": { "description": "active" }, "date": "2025-02-27", "request": { "lat": "46.9488", "lon": "7.4388", "iso": "", "dist": "100", "year": 2022, "class": "4", "charset": "utf-8", "format": "json", "date_format": "Y-m-d", "hl": "de" }, "results": { "status": { "description": "ok" }, "location": { "description": "Bern", "type": "Stadt", "geoId": "410", "iso": "CH", "iso-3166-2": "CH-BE", "note": "", "events": [ { "description": "Neujahr", "id": "1", "dateStart": "2022-01-01", "dateEnd": "2022-01-01", "class": "2", "percent": "100", "prov": "0", "note": null }, { "description": "Berchtoldstag", "id": "3", "dateStart": "2022-01-02", "dateEnd": "2022-01-02", "class": "2", "percent": "100", "prov": "0", "note": null }, { "description": "Karfreitag", "id": "17", "dateStart": "2022-04-15", "dateEnd": "2022-04-15", "class": "2", "percent": "100", "prov": "0", "note": null }, { "description": "Ostern", "id": "18", "dateStart": "2022-04-17", "dateEnd": "2022-04-17", "class": "4", "percent": "100", "prov": "0", "note": null }, { "description": "Ostermontag", "id": "19", "dateStart": "2022-04-18", "dateEnd": "2022-04-18", "class": "2", "percent": "100", "prov": "0", "note": null }, { "description": "Auffahrt", "id": "31", "dateStart": "2022-05-26", "dateEnd": "2022-05-26", "class": "2", "percent": "100", "prov": "0", "note": null }, { "description": "Pfingsten", "id": "30", "dateStart": "2022-06-05", "dateEnd": "2022-06-05", "class": "4", "percent": "100", "prov": "0", "note": null }, { "description": "Pfingstmontag", "id": "35", "dateStart": "2022-06-06", "dateEnd": "2022-06-06", "class": "2", "percent": "100", "prov": "0", "note": null }, { "description": "Nationalfeiertag Schweiz", "id": "12", "dateStart": "2022-08-01", "dateEnd": "2022-08-01", "class": "2", "percent": "100", "prov": "0", "note": null }, { "description": "Weihnachten", "id": "23", "dateStart": "2022-12-25", "dateEnd": "2022-12-25", "class": "2", "percent": "100", "prov": "0", "note": null }, { "description": "Stephanstag", "id": "37", "dateStart": "2022-12-26", "dateEnd": "2022-12-26", "class": "2", "percent": "100", "prov": "0", "note": null }, { "name": "Weihnachtsferien", "description": "Weihnachtsferien", "id": "530660", "dateStart": "2021-12-25", "dateEnd": "2022-01-09", "class": "0", "percent": "100", "prov": "0", "note": null }, { "name": "Sportferien", "description": "Sportferien", "id": "531963", "dateStart": "2022-02-05", "dateEnd": "2022-02-13", "class": "0", "percent": "100", "prov": "0", "note": "DIN Woche 6" }, { "name": "Frühlingsferien", "description": "Frühlingsferien", "id": "530661", "dateStart": "2022-04-09", "dateEnd": "2022-04-24", "class": "0", "percent": "100", "prov": "0", "note": null }, { "name": "Auffahrtsferien", "description": "Auffahrtsferien", "id": "732799", "dateStart": "2022-05-26", "dateEnd": "2022-05-29", "class": "0", "percent": "100", "prov": "0", "note": null }, { "name": "Pfingstmontag", "description": "Pfingstmontag", "id": "732800", "dateStart": "2022-06-06", "dateEnd": "2022-06-06", "class": "0", "percent": "100", "prov": "0", "note": null }, { "name": "Sommerferien", "description": "Sommerferien", "id": "530662", "dateStart": "2022-07-09", "dateEnd": "2022-08-14", "class": "0", "percent": "100", "prov": "0", "note": null }, { "name": "Herbstferien", "description": "Herbstferien", "id": "530663", "dateStart": "2022-09-24", "dateEnd": "2022-10-16", "class": "0", "percent": "100", "prov": "0", "note": null }, { "name": "Weihnachtsferien", "description": "Weihnachtsferien", "id": "530664", "dateStart": "2022-12-24", "dateEnd": "2023-01-08", "class": "0", "percent": "100", "prov": "0", "note": null } ] } } }
URL:
https://www.feiertagskalender.ch/api/Data/LatLon/index.php?api_key=YOUR_API_KEY&lat=46.9488&lon=7.4388&year=2022&format=xml
Antwort des APIs:
<fcal_api> <interface>fcal API 2.02</interface> <source> <href>https://feiertagskalender.ch</href> <description>feiertagskalender.ch</description> </source> <copyright> <href>https://psc.ch</href> <description>psc Peter Schuetz Informatik-Dienstleistungen, CH Bern</description> </copyright> <apiStatus> <description>active</description> </apiStatus> <apiName>Data/LatLon</apiName> <date>2025-02-27</date> <request> <lat>46.9488</lat> <lon>7.4388</lon> <iso></iso> <dist>100</dist> <year>2022</year> <class>4</class> <charset>utf-8</charset> <format>xml</format> <date_format>Y-m-d</date_format> <hl>de</hl> </request> <results> <status> <description>ok</description> </status> <location> <description>Bern</description> <type>Stadt</type> <geoId>410</geoId> <iso>CH</iso> <iso-3166-2>CH-BE</iso-3166-2> <note></note> <events> <event> <description>Neujahr</description> <id>1</id> <dateStart>2022-01-01</dateStart> <dateEnd>2022-01-01</dateEnd> <class>2</class> <percent>100</percent> <prov>0</prov> <note></note> </event> <event> <description>Berchtoldstag</description> <id>3</id> <dateStart>2022-01-02</dateStart> <dateEnd>2022-01-02</dateEnd> <class>2</class> <percent>100</percent> <prov>0</prov> <note></note> </event> <event> <description>Karfreitag</description> <id>17</id> <dateStart>2022-04-15</dateStart> <dateEnd>2022-04-15</dateEnd> <class>2</class> <percent>100</percent> <prov>0</prov> <note></note> </event> <event> <description>Ostern</description> <id>18</id> <dateStart>2022-04-17</dateStart> <dateEnd>2022-04-17</dateEnd> <class>4</class> <percent>100</percent> <prov>0</prov> <note></note> </event> <event> <description>Ostermontag</description> <id>19</id> <dateStart>2022-04-18</dateStart> <dateEnd>2022-04-18</dateEnd> <class>2</class> <percent>100</percent> <prov>0</prov> <note></note> </event> <event> <description>Auffahrt</description> <id>31</id> <dateStart>2022-05-26</dateStart> <dateEnd>2022-05-26</dateEnd> <class>2</class> <percent>100</percent> <prov>0</prov> <note></note> </event> <event> <description>Pfingsten</description> <id>30</id> <dateStart>2022-06-05</dateStart> <dateEnd>2022-06-05</dateEnd> <class>4</class> <percent>100</percent> <prov>0</prov> <note></note> </event> <event> <description>Pfingstmontag</description> <id>35</id> <dateStart>2022-06-06</dateStart> <dateEnd>2022-06-06</dateEnd> <class>2</class> <percent>100</percent> <prov>0</prov> <note></note> </event> <event> <description>Nationalfeiertag Schweiz</description> <id>12</id> <dateStart>2022-08-01</dateStart> <dateEnd>2022-08-01</dateEnd> <class>2</class> <percent>100</percent> <prov>0</prov> <note></note> </event> <event> <description>Weihnachten</description> <id>23</id> <dateStart>2022-12-25</dateStart> <dateEnd>2022-12-25</dateEnd> <class>2</class> <percent>100</percent> <prov>0</prov> <note></note> </event> <event> <description>Stephanstag</description> <id>37</id> <dateStart>2022-12-26</dateStart> <dateEnd>2022-12-26</dateEnd> <class>2</class> <percent>100</percent> <prov>0</prov> <note></note> </event> <event> <description>Weihnachtsferien</description> <id>530660</id> <dateStart>2021-12-25</dateStart> <dateEnd>2022-01-09</dateEnd> <class>0</class> <percent>100</percent> <prov>0</prov> <note></note> </event> <event> <description>Sportferien</description> <id>531963</id> <dateStart>2022-02-05</dateStart> <dateEnd>2022-02-13</dateEnd> <class>0</class> <percent>100</percent> <prov>0</prov> <note>DIN Woche 6</note> </event> <event> <description>Frühlingsferien</description> <id>530661</id> <dateStart>2022-04-09</dateStart> <dateEnd>2022-04-24</dateEnd> <class>0</class> <percent>100</percent> <prov>0</prov> <note></note> </event> <event> <description>Auffahrtsferien</description> <id>732799</id> <dateStart>2022-05-26</dateStart> <dateEnd>2022-05-29</dateEnd> <class>0</class> <percent>100</percent> <prov>0</prov> <note></note> </event> <event> <description>Pfingstmontag</description> <id>732800</id> <dateStart>2022-06-06</dateStart> <dateEnd>2022-06-06</dateEnd> <class>0</class> <percent>100</percent> <prov>0</prov> <note></note> </event> <event> <description>Sommerferien</description> <id>530662</id> <dateStart>2022-07-09</dateStart> <dateEnd>2022-08-14</dateEnd> <class>0</class> <percent>100</percent> <prov>0</prov> <note></note> </event> <event> <description>Herbstferien</description> <id>530663</id> <dateStart>2022-09-24</dateStart> <dateEnd>2022-10-16</dateEnd> <class>0</class> <percent>100</percent> <prov>0</prov> <note></note> </event> <event> <description>Weihnachtsferien</description> <id>530664</id> <dateStart>2022-12-24</dateStart> <dateEnd>2023-01-08</dateEnd> <class>0</class> <percent>100</percent> <prov>0</prov> <note></note> </event> </events> </location> </results> </fcal_api>
URL:
https://www.feiertagskalender.ch/api/Data/LatLon/index.php?api_key=YOUR_API_KEY&lat=46.9488&lon=7.4388&year=2022&format=csv
Antwort des APIs:
"location";"geoId";"description";"id";"dateStart";"dateEnd";"class";"percent";"prov";"note" "Bern";"410";"Neujahr";"1";"2022-01-01";"2022-01-01";"2";"100";"0";"" "Bern";"410";"Berchtoldstag";"3";"2022-01-02";"2022-01-02";"2";"100";"0";"" "Bern";"410";"Karfreitag";"17";"2022-04-15";"2022-04-15";"2";"100";"0";"" "Bern";"410";"Ostern";"18";"2022-04-17";"2022-04-17";"4";"100";"0";"" "Bern";"410";"Ostermontag";"19";"2022-04-18";"2022-04-18";"2";"100";"0";"" "Bern";"410";"Auffahrt";"31";"2022-05-26";"2022-05-26";"2";"100";"0";"" "Bern";"410";"Pfingsten";"30";"2022-06-05";"2022-06-05";"4";"100";"0";"" "Bern";"410";"Pfingstmontag";"35";"2022-06-06";"2022-06-06";"2";"100";"0";"" "Bern";"410";"Nationalfeiertag Schweiz";"12";"2022-08-01";"2022-08-01";"2";"100";"0";"" "Bern";"410";"Weihnachten";"23";"2022-12-25";"2022-12-25";"2";"100";"0";"" "Bern";"410";"Stephanstag";"37";"2022-12-26";"2022-12-26";"2";"100";"0";"" "Bern";"410";"Weihnachtsferien";"530660";"2021-12-25";"2022-01-09";"0";"100";"0";"" "Bern";"410";"Sportferien";"531963";"2022-02-05";"2022-02-13";"0";"100";"0";"DIN Woche 6" "Bern";"410";"Frühlingsferien";"530661";"2022-04-09";"2022-04-24";"0";"100";"0";"" "Bern";"410";"Auffahrtsferien";"732799";"2022-05-26";"2022-05-29";"0";"100";"0";"" "Bern";"410";"Pfingstmontag";"732800";"2022-06-06";"2022-06-06";"0";"100";"0";"" "Bern";"410";"Sommerferien";"530662";"2022-07-09";"2022-08-14";"0";"100";"0";"" "Bern";"410";"Herbstferien";"530663";"2022-09-24";"2022-10-16";"0";"100";"0";"" "Bern";"410";"Weihnachtsferien";"530664";"2022-12-24";"2023-01-08";"0";"100";"0";""
Art der Ausgabe | Fehlermeldung | Erläuterung |
---|---|---|
results: status: | ||
results: status: description | not subscribed | Sie haben die gewünschten Daten nicht abonniert. |
results: status: description | unknown location | Die angeforderten Koordinaten konnten nicht zugeordnet werden. Die Koordinaten liegen ausserhalb des erfassten Gebiets, oder sind ungültig. Prüfen Sie bitte die Parameter lat und lon |
apiStatus | ||
apiStatus: description | invalid usage | Die Verwendung dieses API ist für diesen Nutzer nicht freigeschaltet. |
apiStatus: description | invalid key | Ungültiger API-Schlüssel. |
apiStatus: description | invalid referer | Ungültiger Zugriff. Links ab Webseiten (Front-Ends) sind nicht zulässig. |
apiStatus: description | inactive | Das API wurde für noch nicht zur Benutzung freigeschaltet. |
apiStatus: description | expired | Die Nutzungsdauer nach Vertrag ist abgelaufen. |