API Kalendarz świąt 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
— klasa limitu: cheap
| Parametr | Opis |
|---|---|
country | Kod kraju ISO-2, lub lista do 15 kodów oddzielonych przecinkami, np. PL lub PL,DE,UA. Pominięcie dla domyślnego zestawu (UA,PL,SK,HU,RO,MD,DE,CZ,BG,AT). Jeden kod zwraca płaski obiekt; kilka kodów — listę. |
compare_to | Kod ISO-2 kraju lub lista oddzielona przecinkami do porównania. Przełącza tryb porównywania: zwraca, które daty świąteczne są wspólne DLA WSZYSTKICH wybranych krajów (takie same) oraz które tylko dla niektórych (różne, z osobnymi listami w/nie_w dla każdej daty). Parametry upcoming i days działają z tym — zawężają te same/różne do wybranego okna dat zamiast całego roku. |
year | YYYY (domyślnie: bieżący rok) |
upcoming | 1 = płaska lista nadchodzących świąt w poszczególnych krajach w ciągu kilku dni (opcjonalnie) |
days | Horyzont w dniach dla trybu "nadchodzący", 1-180. Pominięcie lub 0 oznacza brak limitu — wszystko, co widzi podstawowa usługa, w tym roku i następnym. |
lang | Język(i) dla lokalizowanej nazwy pola (domyślnie en), identycznie jak na stronie kalendarza świąt nakordoni.eu z 24 językami. Dla niezasobowanych danych używana jest nazwa lokalna lub angielska. Lista oddzielona przecinkami, maksymalnie 10 języków, np. lang=en,uk,pl — nazwa pobierana z pierwszego żądanego języka; każde święto posiada również obiekt names kluczowany kodami języków zawierający wszystkie tłumaczenia. |
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. Zaloguj się