API v1 · stable · CC-BY-4.0

Finnish public holidays as JSON

Free, open, no auth. One URL gets you every Finnish public holiday and long-weekend opportunity for the year.

One curl, one JSON file. No keys, no signup.

terminalSample session · response truncated

$ 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
    }
  ]
}

Endpoints

Two routes today, both returning a single JSON file per year. Pick one to see its shape.

GETHolidays /api/v1/fi/holidays/{year}.json GETLong weekends /api/v1/fi/long-weekends/{year}.json

Endpoint: GET /api/v1/fi/holidays/{year}.json

Example: https://vapaapaivat.com/api/v1/fi/holidays/2026.json

Dates, names, and whether each date is an official holiday, weekend, or business day. Use a year from 2000 to 2099. The /fi/ path segment identifies Finland.

Top-level response

Field	Type	Description
`apiVersion`	string	API version
`jurisdiction`	string	Country, FI
`year`	number	Calendar year
`timezone`	string	Timezone Europe/Helsinki
`holidays`	array	Holiday item fields

Holiday item fields

Field	Type	Description
`id`	string	Stable holiday identifier
`date`	string	ISO date, YYYY-MM-DD
`name`	object	Names in fi, sv, en, ar, ru, uk, and et
`official`	boolean	Official public holiday
`weekend`	boolean	Falls on Saturday or Sunday
`businessDay`	boolean	Finnish business day

Endpoint: GET /api/v1/fi/long-weekends/{year}.json

Example: https://vapaapaivat.com/api/v1/fi/long-weekends/2026.json

Vacation days that can turn public holidays and weekends into longer breaks. Use a year from 2000 to 2099. The /fi/ path segment identifies Finland.

Top-level response

Field	Type	Description
`apiVersion`	string	API version
`jurisdiction`	string	Country, FI
`year`	number	Calendar year
`timezone`	string	Timezone Europe/Helsinki
`longWeekends`	array	Long-weekend item fields

Long-weekend item fields

Field	Type	Description
`startDate`	string	Start of the break, YYYY-MM-DD
`endDate`	string	End of the break, YYYY-MM-DD
`vacationDays`	string[]	Vacation days to use
`vacationDayCount`	number	Number of vacation days
`totalDaysOff`	number	Consecutive days off
`efficiency`	number	Days off per vacation day
`season`	string	winter or summer

jsonResponse · truncated

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

Stability

v1 is stable. New years roll out each November. Non-breaking additions stay in v1; any breaking change ships under /api/v2/.

Spot a wrong date or a missing language? Report it. Looking for municipal school-holiday data? See datasets. openapi.json

Try it

Endpoints

Stability