[Holt Feiertage und Schulferien für ein ganzes Jahr, basierend auf einer Schweizer Gemeindenummer (BFS).]
[Ö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/CH/BFS/index.php
[Mit den folgenden Variablen können Sie die Abfrage vervollständigen und die API-Ergebnisse steuern.]
| [Parameter] | [Erläuterung] | Ejemplos |
|---|---|---|
| api_key [erforderlich] |
[Ihr API-Schlüssel] | api_key=abc-123-def-456 |
| BFS [erforderlich] |
[Schweizer Gemeindenummer nach BFS (Bundesamt für Statistik)] | &BFS=371 |
| 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 | El formato de salida deseado [Varianten:] |
format=xml |
| date_format | El formato de fecha deseado [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)
Tenga en cuenta que la salida en formato CSV es diferente.
| Array | [Erläuterung] | Ejemplo | ||||
|---|---|---|---|---|---|---|
| interface | [Version des API] | |||||
| source: | href | [URL zur Datenquelle (Website)] | ||||
| description | Nombre de la fuente de datos | |||||
| copyright | href | [URL zum Inhaber des Copyrights (Website)] | ||||
| description | Designación del titular de los derechos de autor | |||||
| apiName | [Identifikation des API] | Data/CH/BFS | ||||
| apiStatus | description | Designación del estado de la API. [Für Varianten, siehe unter] [Fehlermeldungen] | active | |||
| date | Fecha de exportación de los datos | 29.10.2025 | ||||
| request: | bfs | Número de comunidad FSO | 371 | |||
| 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 | Formato de los datos de salida | json | ||||
| hl | [Sprache der Ausgabe, gemäss Anfrage] | es | ||||
| results | status | description | [Status der Ausgabe]. [Für Varianten, siehe unter] [Fehlermeldungen] | ok | ||
| location | description | Designación de la unidad geográfica | Biel | |||
| type | Designación del tipo de unidad geográfica | Stadt | ||||
| geoId | [Geo-ID der geografischen Einheit.] | 424 | ||||
| iso | [ISO-Landeskürzel, 2-stellig] | CH | ||||
| iso-3166-2 | [Regionencode nach ISO 3166-2] | CH-BE | ||||
| note | Notas especiales | |||||
| events | [Die Kalenderevents] | |||||
| description | Designación del día festivo o de las vacaciones escolares | [Neujahr] | ||||
| id | ID único del evento. Los días festivos tienen el mismo ID cada año. Los días festivos escolares tienen cada uno su propio ID. |
1 | ||||
| dateStart | Fecha Inicio del acto | 01.01.2015 | ||||
| dateEnd | Fecha de finalización del acto | 01.01.2015 | ||||
| class | [Klasse des Events:] 0 = [Schulferien] 1 = [gesetzlich anerkannter Feiertag] 2 = Día festivo al igual que el domingo 3 = [halber, gesetzlich anerkannter Feiertag ] (normalmente a partir del mediodía) 4 = [gesetzlich nicht anerkannter Feiertag] (comercios, escuelas, administraciones cerradas en su mayoría), día festivo; a efectos del Convenio Europeo sobre el Cómputo de Plazos, este día se considera festivo (art. 5). 5 = [Ereignistag] # = parcialmente válido |
2 | ||||
| percent | [Umfang der betroffenen Einwohner / Schulklassen in Prozent] | 100 | ||||
| prov | [Flag für provisorisch festgelegte Daten] 0 = definitivamente 1 = [provisorisch] |
0 | ||||
| note | notas especiales |
URL:
https://www.feiertagskalender.ch/api/Data/CH/BFS/index.php?api_key=YOUR_API_KEY&bfs=261&year=2022
Respuesta de la API:
{
"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/CH/BFS",
"apiStatus": {
"description": "active"
},
"date": "2025-02-27",
"request": {
"bfs": "261",
"year": 2022,
"class": "4",
"charset": "utf-8",
"format": "json",
"date_format": "Y-m-d",
"hl": "de"
},
"results": {
"status": {
"description": "ok"
},
"location": {
"description": "Zürich",
"type": "Stadt",
"geoId": "3055",
"iso": "CH",
"iso-3166-2": "CH-ZH",
"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": "4",
"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": "Sechseläuten",
"id": "20",
"dateStart": "2022-04-25",
"dateEnd": "2022-04-25",
"class": "4",
"percent": "100",
"prov": "0",
"note": null
},
{
"description": "Tag der Arbeit",
"id": "22",
"dateStart": "2022-05-01",
"dateEnd": "2022-05-01",
"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": "Knabenschiessen",
"id": "60",
"dateStart": "2022-09-12",
"dateEnd": "2022-09-12",
"class": "4",
"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
},
{
"description": "Weihnachtsferien",
"id": "629306",
"dateStart": "2021-12-20",
"dateEnd": "2022-01-01",
"class": "0",
"percent": "100",
"prov": "0",
"note": null
},
{
"description": "Sportferien",
"id": "629307",
"dateStart": "2022-02-14",
"dateEnd": "2022-02-25",
"class": "0",
"percent": "100",
"prov": "0",
"note": null
},
{
"description": "Osterferien",
"id": "629308",
"dateStart": "2022-04-14",
"dateEnd": "2022-04-18",
"class": "0",
"percent": "100",
"prov": "0",
"note": null
},
{
"description": "Frühlingsferien",
"id": "629309",
"dateStart": "2022-04-18",
"dateEnd": "2022-04-29",
"class": "0",
"percent": "100",
"prov": "0",
"note": null
},
{
"description": "Auffahrtsferien",
"id": "629310",
"dateStart": "2022-05-26",
"dateEnd": "2022-05-29",
"class": "0",
"percent": "100",
"prov": "0",
"note": null
},
{
"description": "Pfingstmontag",
"id": "629311",
"dateStart": "2022-06-06",
"dateEnd": "2022-06-06",
"class": "0",
"percent": "100",
"prov": "0",
"note": null
},
{
"description": "Sommerferien",
"id": "629312",
"dateStart": "2022-07-18",
"dateEnd": "2022-08-19",
"class": "0",
"percent": "100",
"prov": "0",
"note": null
},
{
"description": "Knabenschiessen",
"id": "629313",
"dateStart": "2022-09-12",
"dateEnd": "2022-09-12",
"class": "0",
"percent": "100",
"prov": "0",
"note": null
},
{
"description": "Herbstferien",
"id": "629314",
"dateStart": "2022-10-10",
"dateEnd": "2022-10-21",
"class": "0",
"percent": "100",
"prov": "0",
"note": null
},
{
"description": "Weihnachtsferien",
"id": "629315",
"dateStart": "2022-12-26",
"dateEnd": "2023-01-06",
"class": "0",
"percent": "100",
"prov": "0",
"note": null
}
]
}
}
}
URL:
https://www.feiertagskalender.ch/api/Data/CH/BFS/index.php?api_key=YOUR_API_KEY&bfs=261&year=2022&format=xml
Respuesta de la API:
<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/CH/BFS</apiName> <date>2025-02-27</date> <request> <bfs>261</bfs> <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>Zürich</description> <type>Stadt</type> <geoId>3055</geoId> <iso>CH</iso> <iso-3166-2>CH-ZH</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>4</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>Sechseläuten</description> <id>20</id> <dateStart>2022-04-25</dateStart> <dateEnd>2022-04-25</dateEnd> <class>4</class> <percent>100</percent> <prov>0</prov> <note></note> </event> <event> <description>Tag der Arbeit</description> <id>22</id> <dateStart>2022-05-01</dateStart> <dateEnd>2022-05-01</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>Knabenschiessen</description> <id>60</id> <dateStart>2022-09-12</dateStart> <dateEnd>2022-09-12</dateEnd> <class>4</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>629306</id> <dateStart>2021-12-20</dateStart> <dateEnd>2022-01-01</dateEnd> <class>0</class> <percent>100</percent> <prov>0</prov> <note></note> </event> <event> <description>Sportferien</description> <id>629307</id> <dateStart>2022-02-14</dateStart> <dateEnd>2022-02-25</dateEnd> <class>0</class> <percent>100</percent> <prov>0</prov> <note></note> </event> <event> <description>Osterferien</description> <id>629308</id> <dateStart>2022-04-14</dateStart> <dateEnd>2022-04-18</dateEnd> <class>0</class> <percent>100</percent> <prov>0</prov> <note></note> </event> <event> <description>Frühlingsferien</description> <id>629309</id> <dateStart>2022-04-18</dateStart> <dateEnd>2022-04-29</dateEnd> <class>0</class> <percent>100</percent> <prov>0</prov> <note></note> </event> <event> <description>Auffahrtsferien</description> <id>629310</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>629311</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>629312</id> <dateStart>2022-07-18</dateStart> <dateEnd>2022-08-19</dateEnd> <class>0</class> <percent>100</percent> <prov>0</prov> <note></note> </event> <event> <description>Knabenschiessen</description> <id>629313</id> <dateStart>2022-09-12</dateStart> <dateEnd>2022-09-12</dateEnd> <class>0</class> <percent>100</percent> <prov>0</prov> <note></note> </event> <event> <description>Herbstferien</description> <id>629314</id> <dateStart>2022-10-10</dateStart> <dateEnd>2022-10-21</dateEnd> <class>0</class> <percent>100</percent> <prov>0</prov> <note></note> </event> <event> <description>Weihnachtsferien</description> <id>629315</id> <dateStart>2022-12-26</dateStart> <dateEnd>2023-01-06</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/CH/BFS/index.php?api_key=YOUR_API_KEY&bfs=261&year=2022&format=csv
Respuesta de la API:
"location";"bfs";"description";"id";"dateStart";"dateEnd";"class";"percent";"prov";"note" "Zürich";"261";"Neujahr";"1";"2022-01-01";"2022-01-01";"2";"100";"0";"" "Zürich";"261";"Berchtoldstag";"3";"2022-01-02";"2022-01-02";"4";"100";"0";"" "Zürich";"261";"Karfreitag";"17";"2022-04-15";"2022-04-15";"2";"100";"0";"" "Zürich";"261";"Ostern";"18";"2022-04-17";"2022-04-17";"4";"100";"0";"" "Zürich";"261";"Ostermontag";"19";"2022-04-18";"2022-04-18";"2";"100";"0";"" "Zürich";"261";"Sechseläuten";"20";"2022-04-25";"2022-04-25";"4";"100";"0";"" "Zürich";"261";"Tag der Arbeit";"22";"2022-05-01";"2022-05-01";"2";"100";"0";"" "Zürich";"261";"Auffahrt";"31";"2022-05-26";"2022-05-26";"2";"100";"0";"" "Zürich";"261";"Pfingsten";"30";"2022-06-05";"2022-06-05";"4";"100";"0";"" "Zürich";"261";"Pfingstmontag";"35";"2022-06-06";"2022-06-06";"2";"100";"0";"" "Zürich";"261";"Nationalfeiertag Schweiz";"12";"2022-08-01";"2022-08-01";"2";"100";"0";"" "Zürich";"261";"Knabenschiessen";"60";"2022-09-12";"2022-09-12";"4";"100";"0";"" "Zürich";"261";"Weihnachten";"23";"2022-12-25";"2022-12-25";"2";"100";"0";"" "Zürich";"261";"Stephanstag";"37";"2022-12-26";"2022-12-26";"2";"100";"0";"" "Zürich";"261";"Weihnachtsferien";"629306";"2021-12-20";"2022-01-01";"0";"100";"0";"" "Zürich";"261";"Sportferien";"629307";"2022-02-14";"2022-02-25";"0";"100";"0";"" "Zürich";"261";"Osterferien";"629308";"2022-04-14";"2022-04-18";"0";"100";"0";"" "Zürich";"261";"Frühlingsferien";"629309";"2022-04-18";"2022-04-29";"0";"100";"0";"" "Zürich";"261";"Auffahrtsferien";"629310";"2022-05-26";"2022-05-29";"0";"100";"0";"" "Zürich";"261";"Pfingstmontag";"629311";"2022-06-06";"2022-06-06";"0";"100";"0";"" "Zürich";"261";"Sommerferien";"629312";"2022-07-18";"2022-08-19";"0";"100";"0";"" "Zürich";"261";"Knabenschiessen";"629313";"2022-09-12";"2022-09-12";"0";"100";"0";"" "Zürich";"261";"Herbstferien";"629314";"2022-10-10";"2022-10-21";"0";"100";"0";"" "Zürich";"261";"Weihnachtsferien";"629315";"2022-12-26";"2023-01-06";"0";"100";"0";""
| Tipo de salida | [Fehlermeldung] | [Erläuterung] |
|---|---|---|
| results: status: | ||
| results: status: description | not subscribed | [Sie haben die gewünschten Daten nicht abonniert.] |
| results: status: description | unknown location | Die angeforderte BFS-Gemeindenummer ist nicht bekannt. Prüfen Sie bitte den Parameter bfs. |
| 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.] |