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 | 05.12.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. |