Calendrier des jours fériés — API Jours fériés Online
Jours fériés officiels, bancaires, régionaux, religieux et commémoratifs pour 51 pays (Europe + Golfe) et leurs régions, 2020-2035, issus de notre propre moteur de règles des jours fériés. Chaque jour férié indique s'il s'agit d'un jour non travaillé, d'un jour férié bancaire ou s'il tombe pendant les vacances scolaires, si un jour férié tombant un week-end a été reporté à un autre jour, si sa date est encore estimée (calendrier islamique), et si une interdiction de circulation des camions s'applique ce jour-là et à quelles heures. Couvre la règle de la loi martiale en Ukraine (jours fériés listés, mais non chômés) et les reports de jours par décret (transfers[]). Jusqu'à 10 pays par appel ; une année ou toute plage jusqu'à 731 jours.
GET https://nakordoni.eu/api/v2/data/holiday-calendar/holidays
— classe de quota: cheap
| Paramètre | Description |
|---|---|
country | Code pays ISO-2, ou liste séparée par des virgules de 10 au maximum (obligatoire), p. ex. DE ou DE,PL,UA |
year | YYYY, 2020-2035 (par défaut : année en cours). Ignoré si from/to est envoyé |
from | Début de la plage YYYY-MM-DD (avec to ; 731 jours maximum) |
to | Fin de la plage YYYY-MM-DD |
region | Région ISO 3166-2, p. ex. DE-BY (ou BY avec un seul pays) : jours fériés nationaux + ceux de cette région uniquement. Omettre pour toutes les régions |
type | Filtre séparé par des virgules : PUBLIC, BANK, REGIONAL, RELIGIOUS, OBSERVANCE, SCHOOL, OPTIONAL, HALF_DAY, BRIDGE, ou all. Par défaut : tout sauf BRIDGE |
lang | Codes de langue séparés par des virgules pour name.translations (par défaut : toutes les langues disponibles), p. ex. en,uk,pl |
q | Recherche dans les noms des jours fériés (toute langue), p. ex. christmas |
id | Un jour férié par id (les autres filtres sont ignorés) |
school | 1 = liste aussi les périodes de vacances scolaires (school_holidays[]) pour les pays qui les publient |
include | impact = ajoute business_intelligence à chaque jour férié (Pro et supérieur) |
min_impact | Uniquement les jours fériés dont l'impact_score est au moins égal à cette valeur (0-100) ; implique include=impact |
Champs de la réponse — à l’intérieur de l’objet data de l’enveloppe. [] indique une liste : data.items[].name est donc le champ name de chaque élément. Un champ vaut null, est absent ou est une liste vide quand nous n’avons pas de valeur — jamais un espace réservé.
| Champ | Description |
|---|---|
data.holidays[].id | Identifiant stable du jour férié, p. ex. hol_de_christmas_day_2026 — la valeur acceptée par ?id=. Les jours observés (reportés) se terminent par _obs. |
data.holidays[].date | iso (YYYY-MM-DD), year, month, day, day_of_week (ISO 1=lundi..7=dimanche), day_name, is_weekend (week-end du pays). |
data.holidays[].name | en, local (dans local_lang) et translations {lang: name}. |
data.holidays[].location | country_code, scope NATIONAL ou REGIONAL, regions_affected (codes ISO 3166-2). |
data.holidays[].classification | type, is_day_off, is_bank_holiday, is_school_holiday, is_bridge, estimated (date calculée selon le calendrier islamique), note (suspended_martial_law, transferred_by_decree ou null). |
data.holidays[].floating_logic | is_floating, rule (règle de date en langage clair), shifted_from (date d'origine lorsqu'un jour férié tombant un week-end a été reporté). |
data.holidays[].truck_ban | Interdiction de circulation des camions les jours fériés dans ce pays : applies, time_from, time_until (heure locale), min_weight_tons, eve_rule {date,time_from,time_until} pour une interdiction la veille, scope_note. |
data.holidays[].business_intelligence | Avec include=impact sur Pro et supérieur : le même bloc estimé par modèle que renvoie le produit Impact. |
data.transfers[] | Reports de jours par décret dans la fenêtre : date, country_code, kind (day_off | working_day), region, note. |
data.school_holidays[] | Avec school=1 : id, start_date, end_date, name, location. |
data.count | Nombre de jours fériés renvoyés ; countries et window {from,to} reprennent la requête. |
curl "https://nakordoni.eu/api/v2/data/holiday-calendar/holidays?country=DE&year=2026®ion=DE-BY&lang=en,de" \ -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"
Mis à jour