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