API Calendario de Festivos 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
— clase de cuota: cheap
| Parámetro | Descripción |
|---|---|
country | Código de país ISO-2, o lista de hasta 15 códigos separados por comas, ej. PL o PL,DE,UA. Omitir para el conjunto predeterminado (UA,PL,SK,HU,RO,MD,DE,CZ,BG,AT). Un código devuelve un objeto plano; varios códigos devuelven una lista. |
compare_to | Código ISO-2 del país o lista separada por comas para comparar. Activa el modo de comparación: devuelve qué fechas festivas son compartidas por TODOS los países seleccionados (iguales) y cuáles solo por algunos (diferentes, con listas separadas de dentro/fuera para cada fecha). Los parámetros upcoming y days se combinan con esto — reducen iguales/diferentes a la ventana de fechas seleccionada en lugar del año completo. |
year | YYYY (por defecto: año actual) |
upcoming | 1 = lista plana de los próximos días festivos por países en los próximos días (opcional) |
days | Horizonte en días para el modo "próximo", 1-180. Omitido o 0 significa sin límite — todo lo que el servicio subyacente puede ver, este año y el próximo. |
lang | Idioma(s) para el campo de nombre localizado (por defecto en), igual que en la página del calendario de fiestas de nakordoni.eu con 24 idiomas. Para datos no almacenados en caché se usa el nombre local o en inglés. Lista separada por comas, hasta 10 idiomas, ej. lang=en,uk,pl — el nombre se toma del primer idioma solicitado; cada fiesta también tiene un objeto names con claves según los códigos de idioma que contiene todas las traducciones. |
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. Iniciar sesión