API Kalendár sviatkov 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
— trieda kvóty: cheap
| Parameter | Popis |
|---|---|
country | Kód krajiny ISO-2, alebo zoznam až 15 kódov oddelených čiarkou, napr. PL alebo PL,DE,UA. Vynechať pre predvolený súbor (UA,PL,SK,HU,RO,MD,DE,CZ,BG,AT). Jeden kód vráti plochý objekt; viacero kódov vráti zoznam. |
compare_to | Kód ISO-2 krajiny alebo zoznam oddelený čiarkou pre porovnanie. Prepína do porovnávacieho režimu: vracia, ktoré dátumy sviatkov sú spoločné VŠETKÝM vybraným krajinám (rovnaké) a ktoré len niektorým (odlišné, s osobitnými zoznamami v/nie_v pre každý dátum). Parametre upcoming a days sa s tým skladajú — zužujú rovnaké/odlišné na zvolené okno dátumov namiesto celého roka. |
year | YYYY (predvolené: aktuálny rok) |
upcoming | 1 = zoznam nadchádzajúcich sviatkov podľa krajín pre niekoľko dní (nepovinné) |
days | Horizont v dňoch pre režim "nadchádzajúci", 1-180. Vynechané alebo 0 znamená bez obmedzenia — všetko, čo vidí podkladová služba, tento rok a budúci. |
lang | Jazyk(y) pre lokalizované meno poľa (predvolené en), rovnako ako na stránke kalendára sviatkov nakordoni.eu s 24 jazykmi. Pre ne-cacheované dáta sa použije lokálne alebo anglické meno. Zoznam oddelený čiarkou, max. 10 jazykov, napr. lang=en,uk,pl — meno sa berie z prvého požadovaného jazyka; každý sviatok má tiež objekt names s kľúčmi podľa kódov jazykov, ktorý obsahuje všetky preklady. |
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. Prihlásiť sa