Datensets mit den Feiertagen und Schulferien eines Jahres.
Kapitel:
Ermöglicht Abfragen mittels City-ID (ID von Feiertagskalender.ch). Gibt Kalender-Jahresdaten aus (Feiertage und Schulferien) vom 1.01. - 31.12. eines Jahres.
Die verfügbaren City-IDs finden Sie im API: GeoTree/ISO
Zum Abrufen der Daten verwenden Sie folgende URL. Achten Sie bitte auf Gross-Kleinschrift.
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-Key |
?api_key=abc-123-def-456 |
| cityId erforderlich |
City-ID der gewünschten Ortschaft. Verwendet wird die City-ID von Feiertagskalender.ch | &cityid=88 |
| year oder jahr |
Jahr der gewünschten Daten |
&year= 2025 |
| 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 Datumformat 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/CityId | ||||
| apiStatus | description | Bezeichnung des API-Status. Für Varianten, siehe unter Fehlermeldungen | active | |||
| date | Datum des Datenexports | 16.04.2024 | ||||
| request: | cityId | City-ID gemäss Anfrage | 88 | |||
| 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 | Berlin | |||
| cityId | Geo-ID der geografischen Einheit. | 88 | ||||
| iso | ISO-Landeskürzel, 2-stellig | DE | ||||
| iso-3166-2 | Regionencode nach ISO 3166-2 | DE-BE | ||||
| note | Besondere Hinweise | NEU 30.03.2023 | ||||
| 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 |
| Art der Ausgabe | Fehlermeldung | Erläuterung |
|---|---|---|
| results: status: | ||
| results: status: description | not subscribed | Sie haben die gewünschten Daten nicht abonniert. Wenden Sie sich bitte an unseren Support. |
| results: status: description | unknown location | Die angeforderte City-ID ist nicht bekannt. Prüfen Sie bitte den Parameter cityId |
| apiStatus | ||
| apiStatus: description | invalid usage | Die Verwendung dieses API ist für Sie nicht freigeschaltet. Wenden Sie sich bitte an unseren Support. |
| apiStatus: description | invalid key | Ungültiger API-Key. Prüfen Sie bitte Ihren API-Key. |
| apiStatus: description | invalid referer | Ungültiger Zugriff. Links ab Webseiten (Front-Ends) sind nicht zulässig. Richten Sie Ihre Abfrage so ein, dass diese aus einem geschützten Back-End erfolgt. Wenden Sie sich allenfalls an unseren Support. |
| apiStatus: description | inactive | Das API wurde für Sie noch nicht zur Benutzung freigeschaltet. Versuchen Sie es bitte zu einem späteren Zeitpunkt noch einmal. |
| apiStatus: description | expired | Die Nutzungsdauer nach Vertrag ist abgelaufen. Wenden Sie sich für eine Vertragsverlängerung an unsere Administration. |
URL:
https://feiertagskalender.ch/api/Data/CityId/?api_key=YOUR_API_KEY&jahr=2015&date_format=d.m.Y&CityId=88
Antwort des APIs:
{
"interface": "fcal API 2.0",
"source": {
"href": "https://feiertagskalender.ch",
"description": "feiertagskalender.ch"
},
"copyright": {
"href": "https://psc.ch",
"description": "psc Peter Schuetz Informatik-Dienstleistungen, CH Bern"
},
"apiName": "Data/CityId",
"apiStatus": {
"description": "active"
},
"date": "04.08.2017",
"request": {
"cityId": "88",
"year": "2015",
"class": "4",
"charset": "utf-8",
"format": "json",
"hl": "de"
},
"results": {
"status": {
"description": "ok"
}, {
"location": {
"description": "Berlin",
"cityId": "88",
"iso": "DE",
"iso-3166-2": "DE-BE",
"events": [{
"description": "Neujahrstag",
"id": "1",
"dateStart": "01.01.2015",
"dateEnd": "01.01.2015",
"class": "1",
"percent": "100",
"prov": "0",
"note": null
}, {
"description": "Karfreitag",
"id": "17",
"dateStart": "03.04.2015",
"dateEnd": "03.04.2015",
"class": "1",
"percent": "100",
"prov": "0",
"note": null
}, {
"description": "Ostern",
"id": "18",
"dateStart": "05.04.2015",
"dateEnd": "05.04.2015",
"class": "4",
"percent": "100",
"prov": "0",
"note": null
}, {
"description": "Ostermontag",
"id": "19",
"dateStart": "06.04.2015",
"dateEnd": "06.04.2015",
"class": "1",
"percent": "100",
"prov": "0",
"note": null
}, {
"description": "Tag der Arbeit",
"id": "22",
"dateStart": "01.05.2015",
"dateEnd": "01.05.2015",
"class": "1",
"percent": "100",
"prov": "0",
"note": null
}, {
"description": "Christi Himmelfahrt",
"id": "31",
"dateStart": "14.05.2015",
"dateEnd": "14.05.2015",
"class": "1",
"percent": "100",
"prov": "0",
"note": null
}, {
"description": "Pfingsten",
"id": "30",
"dateStart": "24.05.2015",
"dateEnd": "24.05.2015",
"class": "4",
"percent": "100",
"prov": "0",
"note": null
}, {
"description": "Pfingstmontag",
"id": "35",
"dateStart": "25.05.2015",
"dateEnd": "25.05.2015",
"class": "1",
"percent": "100",
"prov": "0",
"note": null
}, {
"description": "Tag der Deutschen Einheit",
"id": "92",
"dateStart": "03.10.2015",
"dateEnd": "03.10.2015",
"class": "1",
"percent": "100",
"prov": "0",
"note": null
}, {
"description": "Volkstrauertag",
"id": "216",
"dateStart": "15.11.2015",
"dateEnd": "15.11.2015",
"class": "4",
"percent": "100",
"prov": "0",
"note": null
}, {
"description": "Weihnachten",
"id": "23",
"dateStart": "25.12.2015",
"dateEnd": "25.12.2015",
"class": "1",
"percent": "100",
"prov": "0",
"note": null
}, {
"description": "Zweiter Weihnachtsfeiertag",
"id": "37",
"dateStart": "26.12.2015",
"dateEnd": "26.12.2015",
"class": "1",
"percent": "100",
"prov": "0",
"note": null
}, {
"description": "Weihnachtsferien",
"id": "119140",
"dateStart": "22.12.2014",
"dateEnd": "2.01.2015",
"class": "0",
"percent": "100",
"prov": "0",
"note": null
}, {
"description": "Winterferien",
"id": "119141",
"dateStart": "2.02.2015",
"dateEnd": "7.02.2015",
"class": "0",
"percent": "100",
"prov": "0",
"note": null
}, {
"description": "Osterferien",
"id": "119142",
"dateStart": "30.03.2015",
"dateEnd": "11.04.2015",
"class": "0",
"percent": "100",
"prov": "0",
"note": null
}, {
"description": "Ferientag",
"id": "119143",
"dateStart": "15.05.2015",
"dateEnd": "15.05.2015",
"class": "0",
"percent": "100",
"prov": "0",
"note": null
}, {
"description": "Ferientag",
"id": "119144",
"dateStart": "15.07.2015",
"dateEnd": "15.07.2015",
"class": "0",
"percent": "100",
"prov": "0",
"note": null
}, {
"description": "Sommerferien",
"id": "119145",
"dateStart": "16.07.2015",
"dateEnd": "28.08.2015",
"class": "0",
"percent": "100",
"prov": "0",
"note": null
}, {
"description": "Herbstferien",
"id": "119146",
"dateStart": "19.10.2015",
"dateEnd": "31.10.2015",
"class": "0",
"percent": "100",
"prov": "0",
"note": null
}, {
"description": "Weihnachtsferien",
"id": "119147",
"dateStart": "23.12.2015",
"dateEnd": "2.01.2016",
"class": "0",
"percent": "100",
"prov": "0",
"note": null
}]
}
}
}
URL:
https://feiertagskalender.ch/api/Data/CityId/?api_key=YOUR_API_KEY&jahr=2015&charset=iso-8859-1&date_format=d.m.Y&CityId=88&format=xml
Antwort des APIs:
<fcal_api> <interface>fcal API 2.0</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/CityId</apiName> <date>04.08.2017</date> <request> <cityId>88</cityId> <year>2015</year> <class>4</class> <charset>utf-8</charset> <format>xml</format> <hl>de</hl> </request> <results> <status> <description>ok</description> </status> <location> <description>Berlin</description> <cityId>88</cityId> <iso>DE</iso> <iso-3166-2>DE-BE</iso-3166-2> <events> <event> <description>Neujahrstag</description> <id>1</id> <dateStart>01.01.2015</dateStart> <dateEnd>01.01.2015</dateEnd> <class>1</class> <percent>100</percent> <prov>0</prov> <note></note> </event> <event> <description>Karfreitag</description> <id>17</id> <dateStart>03.04.2015</dateStart> <dateEnd>03.04.2015</dateEnd> <class>1</class> <percent>100</percent> <prov>0</prov> <note></note> </event> <event> <description>Ostern</description> <id>18</id> <dateStart>05.04.2015</dateStart> <dateEnd>05.04.2015</dateEnd> <class>4</class> <percent>100</percent> <prov>0</prov> <note></note> </event> <event> <description>Ostermontag</description> <id>19</id> <dateStart>06.04.2015</dateStart> <dateEnd>06.04.2015</dateEnd> <class>1</class> <percent>100</percent> <prov>0</prov> <note></note> </event> <event> <description>Tag der Arbeit</description> <id>22</id> <dateStart>01.05.2015</dateStart> <dateEnd>01.05.2015</dateEnd> <class>1</class> <percent>100</percent> <prov>0</prov> <note></note> </event> <event> <description>Christi Himmelfahrt</description> <id>31</id> <dateStart>14.05.2015</dateStart> <dateEnd>14.05.2015</dateEnd> <class>1</class> <percent>100</percent> <prov>0</prov> <note></note> </event> <event> <description>Pfingsten</description> <id>30</id> <dateStart>24.05.2015</dateStart> <dateEnd>24.05.2015</dateEnd> <class>4</class> <percent>100</percent> <prov>0</prov> <note></note> </event> <event> <description>Pfingstmontag</description> <id>35</id> <dateStart>25.05.2015</dateStart> <dateEnd>25.05.2015</dateEnd> <class>1</class> <percent>100</percent> <prov>0</prov> <note></note> </event> <event> <description>Tag der Deutschen Einheit</description> <id>92</id> <dateStart>03.10.2015</dateStart> <dateEnd>03.10.2015</dateEnd> <class>1</class> <percent>100</percent> <prov>0</prov> <note></note> </event> <event> <description>Volkstrauertag</description> <id>216</id> <dateStart>15.11.2015</dateStart> <dateEnd>15.11.2015</dateEnd> <class>4</class> <percent>100</percent> <prov>0</prov> <note></note> </event> <event> <description>Weihnachten</description> <id>23</id> <dateStart>25.12.2015</dateStart> <dateEnd>25.12.2015</dateEnd> <class>1</class> <percent>100</percent> <prov>0</prov> <note></note> </event> <event> <description>Zweiter Weihnachtsfeiertag</description> <id>37</id> <dateStart>26.12.2015</dateStart> <dateEnd>26.12.2015</dateEnd> <class>1</class> <percent>100</percent> <prov>0</prov> <note></note> </event> <event> <description>Weihnachtsferien</description> <id>119140</id> <dateStart>22.12.2014</dateStart> <dateEnd>2.01.2015</dateEnd> <class>0</class> <percent>100</percent> <prov>0</prov> <note></note> </event> <event> <description>Winterferien</description> <id>119141</id> <dateStart>2.02.2015</dateStart> <dateEnd>7.02.2015</dateEnd> <class>0</class> <percent>100</percent> <prov>0</prov> <note></note> </event> <event> <description>Osterferien</description> <id>119142</id> <dateStart>30.03.2015</dateStart> <dateEnd>11.04.2015</dateEnd> <class>0</class> <percent>100</percent> <prov>0</prov> <note></note> </event> <event> <description>Ferientag</description> <id>119143</id> <dateStart>15.05.2015</dateStart> <dateEnd>15.05.2015</dateEnd> <class>0</class> <percent>100</percent> <prov>0</prov> <note></note> </event> <event> <description>Ferientag</description> <id>119144</id> <dateStart>15.07.2015</dateStart> <dateEnd>15.07.2015</dateEnd> <class>0</class> <percent>100</percent> <prov>0</prov> <note></note> </event> <event> <description>Sommerferien</description> <id>119145</id> <dateStart>16.07.2015</dateStart> <dateEnd>28.08.2015</dateEnd> <class>0</class> <percent>100</percent> <prov>0</prov> <note></note> </event> <event> <description>Herbstferien</description> <id>119146</id> <dateStart>19.10.2015</dateStart> <dateEnd>31.10.2015</dateEnd> <class>0</class> <percent>100</percent> <prov>0</prov> <note></note> </event> <event> <description>Weihnachtsferien</description> <id>119147</id> <dateStart>23.12.2015</dateStart> <dateEnd>2.01.2016</dateEnd> <class>0</class> <percent>100</percent> <prov>0</prov> <note></note> </event> </events> </location> </results> </fcal_api>
URL:
https://feiertagskalender.ch/api/Data/CityId/?api_key=YOUR_API_KEY&charset=iso-8859-1&jahr=2015&date_format=d.m.Y&cityId=88&format=csv
Antwort des APIs:
"location";"cityId";"iso";"iso-3166-2";"description";"id";"dateStart";"dateEnd";"class";"percent";"prov";"note"
"Berlin";"88";"DE";"DE-BE";"Neujahrstag";"1";"01.01.2015";"01.01.2015";"1";"100";"0";""
"Berlin";"88";"DE";"DE-BE";"Karfreitag";"17";"03.04.2015";"03.04.2015";"1";"100";"0";""
"Berlin";"88";"DE";"DE-BE";"Ostern";"18";"05.04.2015";"05.04.2015";"4";"100";"0";""
"Berlin";"88";"DE";"DE-BE";"Ostermontag";"19";"06.04.2015";"06.04.2015";"1";"100";"0";""
"Berlin";"88";"DE";"DE-BE";"Tag der Arbeit";"22";"01.05.2015";"01.05.2015";"1";"100";"0";""
"Berlin";"88";"DE";"DE-BE";"Christi Himmelfahrt";"31";"14.05.2015";"14.05.2015";"1";"100";"0";""
"Berlin";"88";"DE";"DE-BE";"Pfingsten";"30";"24.05.2015";"24.05.2015";"4";"100";"0";""
"Berlin";"88";"DE";"DE-BE";"Pfingstmontag";"35";"25.05.2015";"25.05.2015";"1";"100";"0";""
"Berlin";"88";"DE";"DE-BE";"Tag der Deutschen Einheit";"92";"03.10.2015";"03.10.2015";"1";"100";"0";""
"Berlin";"88";"DE";"DE-BE";"Volkstrauertag";"216";"15.11.2015";"15.11.2015";"4";"100";"0";""
"Berlin";"88";"DE";"DE-BE";"Weihnachten";"23";"25.12.2015";"25.12.2015";"1";"100";"0";""
"Berlin";"88";"DE";"DE-BE";"Zweiter Weihnachtsfeiertag";"37";"26.12.2015";"26.12.2015";"1";"100";"0";""
"Berlin";"88";"DE";"DE-BE";"Weihnachtsferien";"119140";"22.12.2014";"2.01.2015";"0";"100";"0";""
"Berlin";"88";"DE";"DE-BE";"Winterferien";"119141";"2.02.2015";"7.02.2015";"0";"100";"0";""
"Berlin";"88";"DE";"DE-BE";"Osterferien";"119142";"30.03.2015";"11.04.2015";"0";"100";"0";""
"Berlin";"88";"DE";"DE-BE";"Ferientag";"119143";"15.05.2015";"15.05.2015";"0";"100";"0";""
"Berlin";"88";"DE";"DE-BE";"Ferientag";"119144";"15.07.2015";"15.07.2015";"0";"100";"0";""
"Berlin";"88";"DE";"DE-BE";"Sommerferien";"119145";"16.07.2015";"28.08.2015";"0";"100";"0";""
"Berlin";"88";"DE";"DE-BE";"Herbstferien";"119146";"19.10.2015";"31.10.2015";"0";"100";"0";""
"Berlin";"88";"DE";"DE-BE";"Weihnachtsferien";"119147";"23.12.2015";"2.01.2016";"0";"100";"0";""