API v1 · vakaa · CC-BY-4.0

Suomen pyhäpäivien API

Hae Suomen pyhäpäivien päivämäärät ja lomapidennykset JSON muodossa. Valitse reitti nähdäksesi osoitemallin, esimerkin ja vastauskentät.

Kokeile

Yksi curl-komento, yksi JSON-tiedosto. Ei avaimia eikä rekisteröitymistä.

terminalEsimerkki-istunto · vastaus lyhennetty

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

Reitit

Kaksi reittiä palauttaa yhden JSON-tiedoston vuotta kohti. Valitse reitti nähdäksesi rakenteen.

GETPyhäpäivät /api/v1/fi/holidays/{year}.json GETLomapidennykset /api/v1/fi/long-weekends/{year}.json

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

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

Päivämäärät, nimet ja tieto siitä, onko päivä lakisääteinen pyhä, viikonloppu tai työpäivä. Käytä vuotta väliltä 2000-2099. Osoitteen /fi/ segmentti tarkoittaa Suomea.

Ylätason vastaus

Kenttä	Tyyppi	Kuvaus
`apiVersion`	string	API versionumero
`jurisdiction`	string	Maa, FI
`year`	number	Kalenterivuosi
`timezone`	string	Aikavyöhyke Europe/Helsinki
`holidays`	array	Pyhäpäivän kentät

Pyhäpäivän kentät

Kenttä	Tyyppi	Kuvaus
`id`	string	Pysyvä pyhäpäivän tunniste
`date`	string	ISO päivämäärä, YYYY-MM-DD
`name`	object	Nimet kielillä fi, sv, en, ar, ru, uk ja et
`official`	boolean	Lakisääteinen pyhäpäivä
`weekend`	boolean	Osuu lauantaille tai sunnuntaille
`businessDay`	boolean	Suomalainen työpäivä

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

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

Lomapäivät, joilla pyhät ja viikonloput voi yhdistää pidemmiksi vapaiksi. Käytä vuotta väliltä 2000-2099. Osoitteen /fi/ segmentti tarkoittaa Suomea.

Ylätason vastaus

Kenttä	Tyyppi	Kuvaus
`apiVersion`	string	API versionumero
`jurisdiction`	string	Maa, FI
`year`	number	Kalenterivuosi
`timezone`	string	Aikavyöhyke Europe/Helsinki
`longWeekends`	array	Lomapidennyksen kentät

Lomapidennyksen kentät

Kenttä	Tyyppi	Kuvaus
`startDate`	string	Vapaan alku, YYYY-MM-DD
`endDate`	string	Vapaan loppu, YYYY-MM-DD
`vacationDays`	string[]	Käytettävät lomapäivät
`vacationDayCount`	number	Lomapäivien määrä
`totalDaysOff`	number	Peräkkäisten vapaapäivien määrä
`efficiency`	number	Vapaapäiviä lomapäivää kohti
`season`	string	winter tai summer

jsonVastaus · lyhennetty

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

Vakaus

v1 on vakaa. Uudet vuodet julkaistaan joka marraskuu. Rikkoutumattomat lisäykset pysyvät v1-versiossa; rikkovat muutokset julkaistaan polussa /api/v2/.

Huomasitko väärän päivän tai puuttuvan kielen? Ilmoita siitä. Etsitkö kuntien koululomadataa? Katso datasets. openapi.json