Obtient les jours fériés et les vacances scolaires pour une année entière, en se basant sur un numéro de commune suisse (BFS).
Ouvre la documentation interactive de l'API avec Swagger, dans laquelle vous pouvez tester et explorer les points finaux de l'API.
Pour récupérer les données, utilisez l'URL suivante. Veuillez faire attention aux majuscules et aux minuscules.
https://feiertagskalender.ch/api/Data/CH/BFS/index.php
Les variables suivantes vous permettent de compléter la requête et de contrôler les résultats de l'API.
Paramètre | Explication | Exemples |
---|---|---|
api_key requis |
Votre clé API | api_key=abc-123-def-456 |
BFS requis |
Numéro de la commune suisse selon l'OFS (Office fédéral de la statistique) | &BFS=371 |
year oubièn jahr |
Année des dates demandées |
year= 2026 |
class oubièn klasse |
Portée des données Variantes : |
klasse=5 |
charset | Le codage souhaité de la réponse Variantes : |
charset=iso-8859-1 |
format | Le format de sortie souhaité Variantes : |
format=xml |
date_format | Le format de date souhaité pour la réponse. Par défaut:`Y-m-d` (ex., 2025-12-31) Variantes : |
date_format=d.m.Y |
hl | Langue de sortie souhaitée Variantes : |
hl=en |
Le contenu des réponses de l'API résulte de :
- les données auxquelles vous avez souscrit (pays, vacances, congés scolaires, années civiles)
- les données officiellement connues des législateurs
- la disponibilité en fonction de nos recherches (situation réelle de notre base de données)
Veuillez noter que la version en format CSV diffère.
Array | Explication | Exemple | ||||
---|---|---|---|---|---|---|
interface | Version de l'API | |||||
source: | href | URL de la source de données (site web) | ||||
description | Nom de la source des données | |||||
copyright | href | URL du titulaire du droit d'auteur (site web) | ||||
description | Désignation du titulaire du droit d'auteur | |||||
apiName | Identification de l'API | Data/CH/BFS | ||||
apiStatus | description | Désignation du statut de l'API. Pour les variantes, voir les Messages d'erreur | active | |||
date | Date d'exportation des données | 01.05.2025 | ||||
request: | bfs | N° OFS de la commune | 371 | |||
year | Année des données dans la production | 2015 | ||||
class | Classe de la requête (concerne l'étendue des données) | 4 | ||||
charset | Codage de la police de la sortie | utf-8 | ||||
format | Format des données de la sortie | json | ||||
hl | Langue de délivrance, selon la demande | fr | ||||
results | status | description | Statut de la confirmation. Pour les variantes, voir les Messages d'erreur | ok | ||
location | description | Nom de l'unité géographique | Bienne | |||
type | Désignation du type d'unité géographique | Stadt | ||||
geoId | Géo-ID de l'unité géographique. | 424 | ||||
iso | Code pays ISO, 2 chiffres | CH | ||||
iso-3166-2 | Code de région selon la norme ISO 3166-2 | CH-BE | ||||
note | Notes spéciales | |||||
events | Les événements du calendrier | |||||
description | Désignation du jour férié, ou des vacances scolaires | Nouvel an | ||||
id | ID unique de l'événement. Les jours fériés ont la même ID chaque année. Les vacances scolaires ont toutes leur propre ID. |
1 | ||||
dateStart | Date Début de l'événement | 01.01.2015 | ||||
dateEnd | Date Fin de l'événement | 01.01.2015 | ||||
class | Classe de l'événement : 0 = Vacances scolaires 1 = jour férié légalement reconnu 2 = Jour férié assimilé aux dimanches 3 = demi-jour férié légal (généralement à partir de midi) 4 = jour férié non reconnu par la loi (magasins, écoles, administrations habituellement fermés), jour férié ; aux fins de la Convention européenne sur le calcul des délais, ce jour est traité comme un jour férié (article 5). 5 = Événement # = partiellement valable |
2 | ||||
percent | Pourcentage d'habitants / de classes d'école touchés | 100 | ||||
prov | Indicateur pour les données définies provisoirement 0 = définitivement 1 = provisoire |
0 | ||||
note | notes spéciales |
URL :
https://www.feiertagskalender.ch/api/Data/CH/BFS/index.php?api_key=YOUR_API_KEY&bfs=261&year=2022
Réponse de l'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
Réponse de l'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
Réponse de l'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";""
Emplacement de la sortie | Message d'erreur | Explication |
---|---|---|
results: status: | ||
results: status: description | not subscribed | Vous n'avez pas souscrit aux données souhaitées. |
results: status: description | unknown location | Le numéro de la municipalité FSO demandé n'est pas connu. Veuillez vérifier le paramètre bfs |
apiStatus | ||
apiStatus: description | invalid usage | L'utilisation de cette API n'est pas activée pour cet utilisateur. |
apiStatus: description | invalid key | Clé API invalide. |
apiStatus: description | invalid referer | Accès non valable. Les liens à partir de pages web (front-ends) ne sont pas autorisés. |
apiStatus: description | inactive | L'API n'a pas encore été activée pour l'utilisation. |
apiStatus: description | expired | La période d'utilisation prévue par le contrat a expiré. |