API Kalendář svátků 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
— třída kvóty: cheap
| Parametr | Popis |
|---|---|
country | ISO-2 kód země, nebo seznam až 15 kódů oddělených čárkou, např. PL nebo PL,DE,UA. Vynechat pro výchozí sadu (UA,PL,SK,HU,RO,MD,DE,CZ,BG,AT). Jeden kód vrátí plochý objekt; několik kódů vrátí seznam. |
compare_to | Kód ISO-2 země nebo seznam oddělený čárkami pro porovnání. Přepíná do režimu porovnávání: vrací, které sváteční dny jsou společné VŠEM vybraným zemím (stejné) a které pouze některým (odlišné, s oddělenými seznamy v/ne_v pro každé datum). Parametry upcoming a days s tím spolupracují — zužují stejné/odlišné na zvolené okno dat místo celého roku. |
year | YYYY (výchozí: aktuální rok) |
upcoming | 1 = plochý seznam nadcházejících svátků podle zemí pro několik dní (nepovinné) |
days | Horizont v dnech pro režim "nadcházející", 1-180. Vynechání nebo 0 znamená bez omezení — vše, co vidí podkladová služba, tento rok a příští. |
lang | Jazyk(y) pro lokalizované pole názvu (výchozí en), stejně jako na stránce kalendáře svátků nakordoni.eu s 24 jazyky. Pro neuložená data se použije místní nebo anglický název. Seznam oddělený čárkami, max. 10 jazyků, např. lang=en,uk,pl — název se bere z prvního požadovaného jazyka; každý svátek má také objekt names s klíči podle kódů jazyků obsahující všechny překlady. |
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. Přihlásit se