API Calendrier des jours fériés Online
Official public holidays per European country — dates, local names and type, each country's full holiday list included. Backed by the same Nager.Date / OpenHolidaysAPI service (7-day cache, locally-computed Kosovo calendar) that powers the nakordoni.eu holiday calendar page and the prediction system's calendar factors. One country returns a flat object; several return the same shape wrapped in a list. upcoming=1 switches to a flat, date-sorted cross-country feed; compare_to switches to a same-vs-different comparison across countries, useful for checking whether a date is a holiday on both sides of a border crossing or just one.
GET https://nakordoni.eu/api/v1/data/holiday-calendar
— classe de quota: cheap
| Paramètre | Description |
|---|---|
country | Code pays ISO-2, ou liste de jusqu'à 15 codes séparés par des virgules, p. ex. PL ou PL,DE,UA. Omettre pour l'ensemble par défaut (UA,PL,SK,HU,RO,MD,DE,CZ,BG,AT). Un code unique retourne un objet plat ; plusieurs codes retournent une liste. |
compare_to | Code ISO-2 de pays, ou liste séparée par des virgules, pour comparaison. Passe en mode comparaison : retourne les dates de jours fériés communes à TOUS les pays sélectionnés (identiques) et celles qui ne le sont que pour certains (différentes, avec des listes séparées de dans/non_dans pour chaque date). Les paramètres upcoming et days s'appliquent ici — ils restreignent les dates identiques/différentes à la fenêtre de dates choisie au lieu de l'année complète. |
year | YYYY (par défaut : année en cours) |
upcoming | 1 = liste plate des prochaines fêtes par pays sur quelques jours (facultatif) |
days | Horizon en jours pour le mode "à venir", 1-180. Omis ou 0 signifie aucune limite — tout ce que le service sous-jacent peut voir, cette année et l'année prochaine. |
lang | Langue(s) pour le champ de nom localisé (par défaut en), comme sur la page du calendrier des fêtes de nakordoni.eu avec 24 langues. Pour les données non mises en cache, le nom local ou anglais est utilisé. Liste séparée par des virgules, jusqu'à 10 langues, ex. lang=en,uk,pl — le nom est pris depuis la première langue demandée; chaque fête possède aussi un objet names avec des clés basées sur les codes de langue contenant toutes les traductions. |
curl "https://nakordoni.eu/api/v1/data/holiday-calendar?country=PL&compare_to=UA&year=2026&lang=en" \ -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"
🔑 Log in as a developer to try this endpoint live in the sandbox — 50 free test calls a day. Connexion