Holiday Calendar API 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
— quota class: cheap
| Parameter | Description |
|---|---|
country | ISO-2 country code, or comma-separated list of up to 15, e.g. PL or PL,DE,UA. Omit for the default core set (UA,PL,SK,HU,RO,MD,DE,CZ,BG,AT). One resolved country returns a flat object; several return a list. |
compare_to | ISO-2 country code, or comma-separated list, to compare against country. Switches to compare mode: returns which holiday dates are shared by ALL selected countries (same) vs only some of them (different, with per-date in/not_in lists). upcoming and days compose with this — they narrow same/different to that date window instead of the full year. |
year | YYYY (default: current year) |
upcoming | 1 = flat list of upcoming holidays across countries within days (optional) |
days | Horizon in days for upcoming mode, 1-180. Omitted or 0 means no limit — everything the underlying service can see, this year plus next. |
lang | Language(s) for the localized name field (default en), same 24-language translator as the nakordoni.eu holiday calendar page. Falls back to the local or English name for anything not yet cached. Comma-separated for several, up to 10, e.g. lang=en,uk,pl — name stays the first requested language; every holiday also gets a names object keyed by language code with all of them. |
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. Log in