Données ouvertes des jours fériés : JSON et ICS

Adresses (stables, version 1)

Tous les fichiers sont statiques et mis en cache un jour. Code pays = ISO 3166-1 alpha-2 en minuscules, codes de région = ISO 3166-2 sans préfixe pays.

https://toolboxday.com/data/v1/holidays/index.json
https://toolboxday.com/data/v1/holidays/{country}/{year}.json
https://toolboxday.com/data/v1/holidays/{country}/{year}.ics

index.json · /data/v1/holidays/de/2027.json · /data/v1/holidays/fr/2027.ics

{
  "date": "2027-01-06",
  "id": "heiligeDreiKoenige",
  "name": "Epiphany",
  "localName": "Heilige Drei Könige",
  "nationwide": false,
  "regions": [
    "BW",
    "BY",
    "ST"
  ]
}

Exemples de code

JavaScript

const res = await fetch('https://toolboxday.com/data/v1/holidays/de/2027.json');
const data = await res.json();
// nationwide holidays + holidays of one state (e.g. Bavaria = "BY")
const byState = data.holidays.filter(
  (h) => h.nationwide || h.regions?.includes('BY')
);
console.log(byState.map((h) => `${h.date} ${h.name}`));

Python

import json, urllib.request

url = "https://toolboxday.com/data/v1/holidays/de/2027.json"
data = json.load(urllib.request.urlopen(url))
for h in data["holidays"]:
    where = "nationwide" if h["nationwide"] else ", ".join(h["regions"])
    print(h["date"], h["name"], "-", where)

curl + jq

curl -s https://toolboxday.com/data/v1/holidays/de/2027.json | jq '.holidays[] | select(.nationwide) | .date'

S’abonner dans son agenda

Les fichiers ICS contiennent les jours fériés nationaux. Google Agenda : « Autres agendas → À partir de l’URL » ; Outlook : « Ajouter un calendrier → S’abonner à partir du web » ; iPhone : « Réglages → Calendrier → Comptes → Ajouter un calendrier avec abonnement ».

https://toolboxday.com/data/v1/holidays/fr/2027.ics

Comment les données sont vérifiées

• Allemagne : calculée à partir des 16 lois régionales sur les jours fériés et du traité d’unification, avec des tests automatiques.
• Autres pays : générés avec python-holidays et comparés à Nager.Date et aux agendas publics de jours fériés de Google. Les pays, années ou régions présentant un écart ne sont pas inclus.
• Les fêtes du calendrier lunaire portent « estimated » : la date peut varier d’un jour selon l’observation de la lune. Sans garantie – la source officielle fait foi.

Vacances scolaires

Les fichiers JSON de l’Allemagne contiennent aussi les vacances scolaires des 16 Länder (source : KMK et ministères régionaux), dans la mesure où elles sont publiées.

Les vacances scolaires d’autres pays (OpenHolidays API) sont disponibles dans un fichier séparé sous Open Database License (ODbL 1.0) : /data/schulferien-welt.json

Une erreur ou un pays manquant ? Écrivez-nous : info@saracai.de