Indica i giorni festivi e le vacanze scolastiche per un anno intero, in base al numero del comune svizzero (BFS).
Apre la documentazione interattiva dell'API con Swagger, dove è possibile testare ed esplorare gli endpoint dell'API.
Per recuperare i dati, utilizzare il seguente URL. Si prega di prestare attenzione alle maiuscole e alle minuscole.
https://feiertagskalender.ch/api/Data/CH/BFS/index.php
Con le seguenti variabili è possibile completare la query e controllare i risultati delle API.
| Parametro | Spiegazione | Esempi |
|---|---|---|
| api_key richiesto |
La vostra chiave API | api_key=abc-123-def-456 |
| BFS richiesto |
Numero del comune svizzero secondo UST (Ufficio federale di statistica) | &BFS=371 |
| year o jahr |
Anno delle date richieste |
year= 2026 |
| class o klasse |
Portata dei dati Varianti: |
klasse=5 |
| charset | La codifica desiderata della risposta Varianti: |
charset=iso-8859-1 |
| format | Il formato di uscita desiderato Varianti: |
format=xml |
| date_format | Il formato della data desiderato per la risposta. Standard:`Y-m-d` (ad esempio, 2025-12-31). Varianti: |
date_format=d.m.Y |
| hl | Lingua desiderata dell'uscita Varianti: |
hl=en |
Il contenuto delle risposte API deriva da:
- i dati che hai sottoscritto (paesi, vacanze, vacanze scolastiche, anni solari)
- i dati ufficialmente noti dei legislatori
- la disponibilità in base alle nostre ricerche (situazione effettiva del nostro database)
Si prega di notare che l'output in formato CSV è diverso.
| Array | Spiegazione | Esempio | ||||
|---|---|---|---|---|---|---|
| interface | Versione dell'API | |||||
| source: | href | URL della fonte dei dati (sito web) | ||||
| description | Nome della fonte dei dati | |||||
| copyright | href | URL al titolare del copyright (sito web) | ||||
| description | Designazione del titolare del diritto d'autore | |||||
| apiName | Identificazione dell'API | Data/CH/BFS | ||||
| apiStatus | description | Designazione dello stato API. Per le varianti, vedere i Messaggi di errore | active | |||
| date | Data di esportazione dei dati | 24.10.2025 | ||||
| request: | bfs | Numero comunità UFS | 371 | |||
| year | Anno dei dati nell'output | 2015 | ||||
| class | Classe della query (riguarda la portata dei dati) | 4 | ||||
| charset | Codifica dei caratteri di output | utf-8 | ||||
| format | Formato dei dati di uscita | json | ||||
| hl | Lingua di emissione, secondo la richiesta | it | ||||
| results | status | description | Stato dell'output. Per le varianti, vedere i Messaggi di errore | ok | ||
| location | description | Nome dell'unità geografica | Bienna | |||
| type | Designazione del tipo di unità geografica | Stadt | ||||
| geoId | Geo-ID dell'unità geografica. | 424 | ||||
| iso | Codice ISO del paese, 2 cifre | CH | ||||
| iso-3166-2 | Codice regione secondo ISO 3166-2 | CH-BE | ||||
| note | Note speciali | |||||
| events | Gli eventi del calendario | |||||
| description | Designazione della festa, o delle vacanze scolastiche | Capodanno | ||||
| id | ID unica dell'evento. Le feste hanno la stessa ID ogni anno. Le vacanze scolastiche hanno tutti un proprio ID. | 1 | ||||
| dateStart | Data Inizio dell'evento | 01.01.2015 | ||||
| dateEnd | Data Fine dell'evento | 01.01.2015 | ||||
| class | Classe dell'evento: 0 = Vacanze scolastiche 1 = giorno festivo riconosciuto legalmente 2 = Giorno festivo alla pari della domenica 3 = giorno di riposo ufficiale (di solito da mezzogiorno) 4 = giorno festivo non riconosciuto legalmente (negozi, scuole, amministrazioni solitamente chiuse), giorno festivo; ai fini della Convenzione europea sul calcolo dei termini, questo giorno è considerato come un giorno festivo (articolo 5). 5 = Giorno evento # = parzialmente valido |
2 | ||||
| percent | Percentuale di abitanti / classi scolastiche interessate | 100 | ||||
| prov | Flag per dati definiti provvisoriamente 0 = sicuramente 1 = provvisorio |
0 | ||||
| note | note speciali |
URL:
https://www.feiertagskalender.ch/api/Data/CH/BFS/index.php?api_key=YOUR_API_KEY&bfs=261&year=2022
Risposta delle 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
Risposta delle 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
Risposta delle 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";""
| Posizione di uscita | Messaggio di errore | Spiegazione |
|---|---|---|
| results: status: | ||
| results: status: description | not subscribed | Non avete sottoscritto i dati desiderati. |
| results: status: description | unknown location | Il numero del comune UST richiesto non è noto. Si prega di controllare il parametro bfs |
| apiStatus | ||
| apiStatus: description | invalid usage | L'uso di questa API non è abilitato per questo utente. |
| apiStatus: description | invalid key | Chiave API non valida. |
| apiStatus: description | invalid referer | Accesso non valido. Non sono ammessi link da pagine web (front-end). |
| apiStatus: description | inactive | L'API non è ancora stata attivata per l'uso. |
| apiStatus: description | expired | Il periodo di utilizzo secondo il contratto è scaduto. |