API v1 · стабільний · CC-BY-4.0

API свят Фінляндії

Отримуйте дати свят Фінляндії та варіанти відпускних мостів у JSON. Виберіть маршрут, щоб побачити шаблон адреси, приклад файлу та поля відповіді.

Спробувати

Одна команда curl, один JSON-файл. Без ключів і реєстрації.

terminalПриклад сеансу · відповідь скорочено

$ curl https://vapaapaivat.com/api/v1/fi/holidays/2026.json
# 200 OK · application/json

{
  "apiVersion": "1",
  "jurisdiction": "FI",
  "year": 2026,
  "timezone": "Europe/Helsinki",
  "holidays": [
    {
      "id": "newyear",
      "date": "2026-01-01",
      "name": {
        "fi": "Uudenvuodenpäivä",
        "en": "New Year's Day",
        "sv": "Nyårsdagen",
        "et": "uusaasta",
        "ru": "Новый год",
        "uk": "Новий рік",
        "ar": "رأس السنة الميلادية"
      },
      "official": true,
      "weekend": false,
      "businessDay": false
    }
  ]
}

Маршрути

Два маршрути повертають по одному JSON-файлу на рік. Виберіть маршрут, щоб побачити структуру.

GETСвята /api/v1/fi/holidays/{year}.json GETВідпускні мости /api/v1/fi/long-weekends/{year}.json

Шаблон адреси: GET /api/v1/fi/holidays/{year}.json

Приклад: https://vapaapaivat.com/api/v1/fi/holidays/2026.json

Дати, назви та відомості про те, чи є день державним святом, вихідним або робочим днем. Використовуйте рік від 2000 до 2099. Сегмент /fi/ в адресі означає Фінляндію.

Відповідь верхнього рівня

Поле	Тип	Опис
`apiVersion`	string	Версія API
`jurisdiction`	string	Країна, FI
`year`	number	Календарний рік
`timezone`	string	Часовий пояс Europe/Helsinki
`holidays`	array	Поля свята

Поля свята

Поле	Тип	Опис
`id`	string	Постійний ідентифікатор свята
`date`	string	Дата ISO, YYYY-MM-DD
`name`	object	Назви мовами fi, sv, en, ar, ru, uk та et
`official`	boolean	Державне свято
`weekend`	boolean	Припадає на суботу або неділю
`businessDay`	boolean	Робочий день у Фінляндії

Шаблон адреси: GET /api/v1/fi/long-weekends/{year}.json

Приклад: https://vapaapaivat.com/api/v1/fi/long-weekends/2026.json

Дні відпустки, які дають змогу об'єднати свята й вихідні у довший відпочинок. Використовуйте рік від 2000 до 2099. Сегмент /fi/ в адресі означає Фінляндію.

Відповідь верхнього рівня

Поле	Тип	Опис
`apiVersion`	string	Версія API
`jurisdiction`	string	Країна, FI
`year`	number	Календарний рік
`timezone`	string	Часовий пояс Europe/Helsinki
`longWeekends`	array	Поля відпускного мосту

Поля відпускного мосту

Поле	Тип	Опис
`startDate`	string	Початок періоду відпочинку, YYYY-MM-DD
`endDate`	string	Кінець періоду відпочинку, YYYY-MM-DD
`vacationDays`	string[]	Використані дні відпустки
`vacationDayCount`	number	Кількість днів відпустки
`totalDaysOff`	number	Кількість вихідних днів поспіль
`efficiency`	number	Вихідних днів на один день відпустки
`season`	string	winter або summer

jsonВідповідь · скорочено

{
  "apiVersion": "1",
  "jurisdiction": "FI",
  "year": 2026,
  "longWeekends": [
    {
      "startDate": "2026-04-03",
      "endDate": "2026-04-06",
      "vacationDays": [],
      "vacationDayCount": 0,
      "totalDaysOff": 4,
      "efficiency": null,
      "season": "spring"
    }
  ]
}

Стабільність

v1 стабільний. Нові роки публікуються щолистопада. Сумісні доповнення залишаються у v1; несумісні зміни публікуються в /api/v2/.

Помітили неправильну дату або відсутню мову? Повідомте про це. Шукаєте муніципальні дані про шкільні канікули? Див. datasets. openapi.json