Skip to main content
Menu

← All endpoints

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 — класа на квота: cheap

ПараметарОпис
countryISO-2 код на државата, или список од до 15 кодови одделени со запирка, н.п. PL или PL,DE,UA. Да се испушти за стандардната поставка (UA,PL,SK,HU,RO,MD,DE,CZ,BG,AT). Еден код враќа рамка објект; неколку кодови враќаат список.
compare_toISO-2 код на државата или список одвоен со запетаја за споредба. Префрла во режим на споредба: враќа кои датуми на празници се заеднички за СИТЕ избрани држави (исти) и кои само за некои (различни, со посебни листи во/не_во за секој датум). Параметрите upcoming и days работат со ова — ги стеснуваат истите/различните во избраниот прозорец на датуми наместо целата година.
yearYYYY (по default: тековна година)
upcoming1 = рамна листа на предстојните празници по земји во неколку дена (опционално)
daysХоризонт во денови за режимот „идни“, 1-180. Исклучување или 0 значи без ограничување — сè што ја гледа основната услуга, оваа година и следната.
langЈазик(и) за локализираното име на полето (по default en), како на страницата за календар на празниците на nakordoni.eu со 24 јазици. За некеширани податоци се користи локалното или англиското име. Списокот е одделен со запетаја, до 10 јазици, нпр. lang=en,uk,pl — името се зема од првиот побаран јазик; секој празник има и објект names со клучеви според кодовите на јазиците, кој ги содржи сите преводи.
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. Најава