Перейти до вмісту
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

ПараметрОпис
countryКод країни ISO-2, або список з до 15 кодів через кому, напр. PL чи PL,DE,UA. Пропустіть для набору за замовчуванням (UA,PL,SK,HU,RO,MD,DE,CZ,BG,AT). Один код повертає плоский об’єкт; кілька кодів — список.
compare_toКод ISO-2 країни, або список через кому, для порівняння. Перемикає режим порівняння: повертає, які дати свят спільні для ВСІХ обраних країн (однакові) та які лише для деяких (різні, з окремими списками в/не в для кожної дати). Параметри upcoming та days працюють з цим — звужують однакові/різні до обраного вікна дат замість повного року.
yearYYYY (за замовчуванням: поточний рік)
upcoming1 = плоский список майбутніх свят по країнах протягом кількох днів (необов'язково)
daysГоризонт у днях для режиму "майбутнє", 1-180. Пропущено або 0 означає відсутність обмеження — усе, що бачить базова служба, цього року та наступного.
langМова(и) для локалізованого імені поля (за замовчуванням 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. Увійти