API-rajapinta

Hae kuluvan vuoden rajattuja kalenteritietoja maksutta ilman rekisteröitymistä tai API-avainta. Laajemmat aineistot ja muut vuodet ovat saatavilla maksullisella API-avaimella.

Avaa API-dokumentaatio

Maksuton API

Maksuton API palauttaa päivien nimet ja tunnisteet. Voit hakea myös kuluvan vuoden kuun vaiheet. Käyttö on sallittu verkkosivuilla, sovelluksissa ja kaupallisissa palveluissa käyttöehtojen mukaisesti.

Päivähaku GET /v1/calendar/days

Osoite

https://api.kalenteri.online/v1/calendar/days?startDate=2026-01-01&endDate=2026-01-01

Otsakkeet

Accept: application/json

API-avainta tai Authorization-otsaketta ei tarvita.

Esimerkkivastaus

{
  "generatedAt": "2026-01-01T00:00:00Z",
  "dateCount": 1,
  "data": {
    "2026-01-01": [
      {
        "id": 100000,
        "name": "Uudenvuodenpäivä"
      }
    ]
  },
  "source": {
    "name": "Kalenteri.online",
    "url": "https://kalenteri.online/"
  }
}

Maksuton käyttö edellyttää lähdemainintaa. Lue käyttöehdot.

REST API:n hakuohjeet

  • Koko vuosi: käytä päivämääräväliä startDate=2026-01-01&endDate=2026-12-31.
  • Kuun vaiheet: hae ne erikseen osoitteesta /v1/calendar/moon-phases samalla päivämäärävälillä.
  • Vastauksen muoto: oletus format=grouped ryhmittelee merkinnät päivämäärän mukaan. Valitse format=list, jos haluat merkinnät yhtenä listana, jossa jokaisella on date-kenttä. Valinta toimii sekä päivähauissa että kuun vaiheiden haussa.

Integraatioita varten on saatavilla REST API:n OpenAPI 3.1 -määrittely.

MCP-yhteys tekoälysovelluksille

MCP:n kautta tekoälysovellus voi hakea Suomen kalenteripäiviä päivämäärällä, aikavälillä tai nimen osalla. Lisää alla oleva palvelinosoite MCP:tä tukevan sovelluksen yhteysasetuksiin.

MCP-palvelimen osoite

https://api.kalenteri.online/v1/mcp

Kuluvan vuoden rajattu aineisto toimii ilman kirjautumista. Oman API-tilauksesi laajemmat aineistot ja vuodet saat käyttöön yhdistämällä Kalenteri.online-tilisi OAuth-kirjautumisella. MCP-yhteyteen ei syötetä API-avainta.

Yhteystyyppi on Streamable HTTP. Valitse sovelluksessa OAuth tai kirjautumisen salliva vaihtoehto, jos haluat yhdistää tilisi.

Tilattavat aineistot

Osta valitsemasi vuoden aineisto ladattavana JSONina ja API-rajapinnan kautta. Hintaan sisältyvät kaupallinen käyttö, Outlook-vienti ja API-käyttöoikeus 12 kuukaudeksi ilman pakollista lähdemainintaa.

Vertaa aineistoja

Kalenteriaineisto – perustiedot

Suomalaisen perinteisen kalenterin juhla- ja pyhäpäivät, liputuspäivät sekä luokittelutiedot valitsemaltasi vuodelta.

Tutustu perustietoihin

Kalenteriaineisto – laajat tiedot

Perustietojen lisäksi epäviralliset päivät, kansalliset ja kansainväliset teemapäivät sekä muut liputuspäivät.

Tutustu laajoihin tietoihin