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. Кіру