API v1 · stabil · CC-BY-4.0

API för finländska helgdagar

Hämta datum för finländska helgdagar och semesterbryggor som JSON. Välj en rutt för att se adressmönster, exempel och svarsfält.

Testa

Ett curl-kommando, en JSON-fil. Inga nycklar och ingen registrering.

terminalExempelsession · svar förkortat

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

Rutter

Två rutter returnerar en JSON-fil per år. Välj en rutt för att se strukturen.

GETHelgdagar /api/v1/fi/holidays/{year}.json GETLånghelger /api/v1/fi/long-weekends/{year}.json

Adressmönster: GET /api/v1/fi/holidays/{year}.json

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

Datum, namn och uppgift om dagen är lagstadgad helgdag, veckoslut eller arbetsdag. Använd ett år mellan 2000 och 2099. Segmentet /fi/ i adressen betyder Finland.

Svar på toppnivå

Fält	Typ	Beskrivning
`apiVersion`	string	API version
`jurisdiction`	string	Land, FI
`year`	number	Kalenderår
`timezone`	string	Tidszon Europe/Helsinki
`holidays`	array	Fält för helgdagar

Fält för helgdagar

Fält	Typ	Beskrivning
`id`	string	Stabil identifierare för helgdagen
`date`	string	ISO datum, YYYY-MM-DD
`name`	object	Namn på fi, sv, en, ar, ru, uk och et
`official`	boolean	Lagstadgad helgdag
`weekend`	boolean	Infaller på lördag eller söndag
`businessDay`	boolean	Finländsk arbetsdag

Adressmönster: GET /api/v1/fi/long-weekends/{year}.json

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

Semesterdagar som kan kombinera helgdagar och veckoslut till längre ledigheter. Använd ett år mellan 2000 och 2099. Segmentet /fi/ i adressen betyder Finland.

Svar på toppnivå

Fält	Typ	Beskrivning
`apiVersion`	string	API version
`jurisdiction`	string	Land, FI
`year`	number	Kalenderår
`timezone`	string	Tidszon Europe/Helsinki
`longWeekends`	array	Fält för långhelger

Fält för långhelger

Fält	Typ	Beskrivning
`startDate`	string	Ledighetens början, YYYY-MM-DD
`endDate`	string	Ledighetens slut, YYYY-MM-DD
`vacationDays`	string[]	Semesterdagar att använda
`vacationDayCount`	number	Antal semesterdagar
`totalDaysOff`	number	Sammanhängande lediga dagar
`efficiency`	number	Lediga dagar per semesterdag
`season`	string	winter eller summer

jsonSvar · förkortat

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

Stabilitet

v1 är stabil. Nya år publiceras varje november. Icke-brytande tillägg stannar i v1; brytande ändringar publiceras under /api/v2/.

Ser du fel datum eller ett språk som saknas? Rapportera det. Söker du kommunala skollovsdata? Se datasets. openapi.json