API Calendario Festività 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
— classe di quota: cheap
| Parametro | Descrizione |
|---|---|
country | Codice paese ISO-2, o elenco di fino a 15 codici separati da virgole, ad es. PL o PL,DE,UA. Omettere per l'insieme predefinito (UA,PL,SK,HU,RO,MD,DE,CZ,BG,AT). Un singolo codice restituisce un oggetto piatto; più codici restituiscono una lista. |
compare_to | Codice ISO-2 del paese o elenco separato da virgole per il confronto. Attiva la modalità di confronto: restituisce quali date festive sono condivise da TUTTI i paesi selezionati (uguali) e quali solo da alcuni (diverse, con elenchi separati di dentro/fuori per ogni data). I parametri upcoming e days si combinano con questo — restringono uguali/diversi alla finestra di date scelta invece che all'intero anno. |
year | YYYY (predefinito: anno corrente) |
upcoming | 1 = lista piatta delle prossime festività per paese nei prossimi giorni (opzionale) |
days | Orizzonte in giorni per la modalità "futuro", 1-180. Omesso o 0 significa senza limiti — tutto ciò che il servizio sottostante può vedere, quest'anno e il prossimo. |
lang | Lingua(e) per il campo nome localizzato (predefinito en), come nella pagina del calendario delle festività di nakordoni.eu con 24 lingue. Per i dati non in cache viene utilizzato il nome locale o inglese. Elenco separato da virgole, fino a 10 lingue, es. lang=en,uk,pl — il nome viene preso dalla prima lingua richiesta; ogni festività ha anche un oggetto names con chiavi basate sui codici lingua che contiene tutte le traduzioni. |
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. Accedi