Kiinteistötietojen kyselypalvelu (REST)

Kiinteistötietojen kyselypalvelu (REST) tarjoaa ajantasaisia kiinteistön omistukseen ja hallintaan liittyviä tietoja XML-formaatissa. Palvelu on suunniteltu tukemaan organisaatioiden toimintaa, kuten yhdyskuntasuunnittelua ja kiinteistönvälitystä. Tietoja voi hakea kiinteistöistä, määräaloista ja vuokraoikeuksista erilaisilla hakuehdoilla. Tiedot tuotetaan ajantasaisesta lainhuuto- ja kiinnitysrekisteristä.

Tietoja voi käyttää mm. seuraaviin käyttötarkoituksiin:

  • Yhdyskuntasuunnittelu
  • Kiinteistönvälitys
  • Kiinteistönarviointi
  • Luoton myöntäminen ja valvonta
  • Viranomaistoiminta

Palvelun tietoja voi käyttää vain organisaation omassa toiminnassa. Tietoja ei saa luovuttaa kolmansille osapuolille. Jos aiot välittää tietoja kolmannelle osapuolelle, tarvitset erillisen luvan ja sopimuksen jälleenmyyntiin. Lue lisää verkkosivuiltamme tietojen välittämisestä eli jälleenmyynnistä.

Lainhuuto- ja kiinnitysrekisterin tietojen käyttö edellyttää lupaa ja sopimusta. Katso lisätietoja osiosta Ota käyttöösi.

Palvelun käyttö on maksullista ja palvelun käyttöön tarvitaan käyttäjätunnus ja salasana. Viranomaiskäyttö on maksutonta. 

Palvelua voi myös koekäyttää. Lue lisätietoja osiosta Koekäyttö.

Palvelussa on joka yö käyttökatko 23.15 - 01.00, jonka aikana rekisteritiedot päivittyvät. Rajapinnan tuki palvelee ma - pe klo 8 - 16.  

Alla olevassa taulukossa on kuvattu palvelusta saatavat tuotteet ja niiden tietosisältö pääpiirteissään.

Tuotteet on saatavilla palvelusta tuotekokonaisuuksina, jotka vaihtelevat tuotteiden ja tietojen laajuuden mukaan. Tuotekokonaisuudet on esitelty Tuotteet -taulukon jälkeen.

Henkilötietoja sisältävistä tuotteista on saatavilla kolme eri tuoteversiota:

  • kaikki skeeman mukaiset henkilötiedot esitetään
  • luonnollisen henkilön henkilötunnusta ei esitetä
  • luonnollisten ja tuntemattomien henkilöiden henkilötietoja ei esitetä

Lakanneista kohteista tulostetaan vain kohteen perustiedot. 

Rekisteriyksiköiden, määräalojen ja laitosten haku hakuehdoin -kyselyllä on mahdollista hakea ensin lista kohteista erilaisilla hakua rajaavilla parametreillä. Tämän jälkeen voi hakea varsinaiset tiedot, esim. lainhuutotiedot, vain tarvittaville kohteille.

Haku hakuehdoin kyselyllä voi hakea muuttuneita kohteista. Muutostapahtumahaku palauttaa myös hakuparametrilla löytyneet muutostapahtumat.

Tuote

 Tiedot
Perustiedot

Rekisteriyksiköstä, määräalasta, erillisenä luovutetusta yhteisalueosuudesta ja laitoksesta mm. seuraavia tietoja:

Rekisteriyksiköt/kiinteistöt:

  • kiinteistötunnus, kunta, nimi, rekisteröintipvm, maapinta-ala

Määräalat:

  • määräalatunnus, sijaintirekisteriyksikkö, sijaintikunta, rekisteröintipvm

Vuokraoikeus/laitos:

  • laitostunnus, kirjaamispvm, vuokranantaja, sijaintikohteet
Lainhuutotiedot

Rekisteriyksiköstä, määräalasta ja erillisenä luovutetusta yhteisalueosuudesta lainhuutotodistusta vastaavat tiedot: 

  • kohteen perustiedot
  • viimeisin kohteelle myönnetty lainhuuto:
    • lainhuudon päivä
    • asianumero
    • omistusosuudet
    • lainhuudon saajan tiedot
    • saantotiedot
Rasitustiedot

Rekisteriyksiköstä, määräalasta, erillisenä luovutetusta yhteisalueosuudesta ja laitoksesta rasitustodistusta vastaavat tiedot: 

  • kohteen perustiedot
  • kiinnitykset
  • erityiset oikeudet
  • muistutustiedot 
Vuokraoikeustiedot

Laitoksesta vuokraoikeustodistusta vastaavat tiedot:

  • vuokraoikeuden perustiedot
  • voimassa oleva vuokraoikeuden haltija
Henkilön omistukset

Kyselyllä saadaan henkilön omistuksessa tai hallinnassa olevia kohteita. Tietoja voidaan hakea henkilötunnuksella tai y-tunnuksella.

Haku voidaan antaa vain viranomaisten käyttöön.
Rekisteriyksiköiden haku hakuehdoin

Kyselyllä voi hakea joukon rekisteriyksiköitä (kiinteistöjä) erilaisilla hakuparametreilla. Hakutapoja on kolme:

  • Kiinteistötunnus
  • Kunta
  • Muutostapahtuma (esim. lainhuudon muutos).

Kyselyyn voi lisätä hakua rajaavia parametreja esim. kunta, pinta-ala, olotila tai muutostapahtuman aikaväli.

Kysely palauttaa suppeat perustiedot kiinteistöistä:

  • kiinteistötunnus
  • olotila
  • rekisteriyksikkölaji
  • suhde peruskiinteistöön,
  • kiinteistön nimi

 
Määräalojen haku hakuehdoin

Kyselyllä voi hakea joukon määräaloja ja erillisenä luovutettuja yhteisalueosuuksia erilaisilla hakuparametreilla. Hakutapoja on kolme:

  • Määräalatunnus
  • Kunta
  • Muutostapahtuma (esim. lainhuudon muutos).

Kyselyyn voi lisätä hakua rajaavia parametreja esim. kunta, pinta-ala, olotila tai muutostapahtuman aikaväli.

Kysely palauttaa suppeat perustiedot määräalasta tai yhteisalueosuudesta

  • määräalatunnus
  • olotila
  • määräalan tyyppi
  • suhde peruskiinteistöön

 
Laitosten haku hakuehdoin

Kyselyllä voi hakea joukon vuokraoikeuksia (laitoksia) erilaisilla hakuparametreilla. Hakutapoja on neljä:

  • Laitostunnus
  • Kunta
  • Kiinteistötunnus
  • Muutostapahtuma (esim. vuokraoikeuden muutos).

Kyselyyn voi lisätä hakua rajaavia parametreja esim. kunta, olotila tai muutostapahtuman aikaväli.

Kysely palauttaa suppeat perustiedot määräalasta tai yhteisalueosuudesta

  • laitostunnus
  • erityisen oikeuden laji
  • olotila

 
Yhteystiedot

Rekisteriyksiköstä ja määräalasta: 

  • hyväksytysti ratkaistujen lainhuutoasioiden saajien nimet ja osoitteet. 

Laitoksesta:

  • hyväksytysti ratkaistujen vuokraoikeuksien vuokralaisten nimet ja osoitteet. 

Tuotteessa esitettävät henkilö- ja osoitetiedot perustuvat väestötietojärjestelmään.

Juridisista henkilöistä (yritykset, yhteisöt, julkisoikeudelliset tahot) esitetään vain Y-tunnus.

Jos lainhuutotiedoissa ei ole henkilötunnusta tai omistaja on kuollut, osoitetietoja ei ole saatavilla.

Jos omistajana on kuolinpesä ja kuolinpesän osakkaat on päivitetty selvennyslainhuudossa rekisteriin, yhteystiedoissa näytetään kaikkien osakkaiden nimet ja osoitteet.

Yhteystietoihin voi liittyä osoitteen luovutuskielto.  Tällöin yhteystietoja ei ole palvelussa saatavilla.
Koodistot Kyselyllä saadaan koodistot koodiarvoineen ja selitteineen.

Voit tutustua tuotteiden sisältöön tarkemmin koekäyttöpalvelun teknisestä kuvauksesta löytyvien esimerkkien avulla.

Tuotekokonaisuudet

Tuotteet on saatavilla palvelusta tuotekokonaisuuksina. Alla olevassa taulukossa on kuvattu mitä Kiinteistötietojen kyselypalvelun (REST) tuotteita tuotekokonaisuudet sisältävät. Hakemuksessa valitaan jokin alla olevista tuotekokonaisuuksista (1-4). Lisäksi taulukossa on kerrottu, mikäli tuotteen haku pitää lokittaa.

 

Tuotteet ja tuoteversiot Tuotekokonaisuudet       Lokitusvaatimus

 

 

 

 1) KTJ:n  laajat tiedot henkilötunnuksin 2) KTJ:n laajat tiedot ilman henkilötunnuksia 3) KTJ:n suppeat tiedot 4) KTJ:n suppeat tiedot ja kiinteistön omistajien yhteystiedot  
Perustiedot *) x x     x
Perustiedot, ilman henkilötunnusta *) x x     x
Perustiedot, ilman luonnollisten henkilöiden henkilötietoja *) x x     x
Lainhuutotiedot, kaikki henkilötiedot x       x
Lainhuutotiedot ilman henkilötunnusta = vain syntymäaika x x     x
Lainhuutotiedot ilman luonnollisten henkilöiden henkilötietoja x x     x
Rasitustiedot, kaikki henkilötiedot x       x
Rasitustiedot ilman henkilötunnusta = vain syntymäaika x x     x
Rasitustiedot ilman luonnollisten henkilöiden henkilötietoja x x     x
Vuokraoikeustiedot, kaikki henkilötiedot x       x
Vuokraoikeustiedot ilman henkilötunnusta = vain syntymäaika x x     x
Vuokraoikeustiedot ilman luonnollisten henkilöiden henkilötietoja x x     x
Yhteystiedot x x   x x
Rekisteriyksiköiden haku hakuehdoin x x x x  
Määräalan haku hakuehdoin x x x x  
Laitosten haku hakuehdoin x x x x  
Henkilön omistukset **) (x)       x

*) Henkilötietoja on vain laitoksen perustiedoissa.

**) Henkilön omistukset -tuote voidaan antaa vain joidenkin viranomaisten käyttöön.

 

Palvelun tarkempi tekninen kuvaus.

Kiinteistötietojen kyselypalvelu (REST)

Product Price € (excl. VAT) Price € (incl. VAT)
1011
Ylläpitomaksu/ palvelutunnus / kk
 		12,00 No VAT
8202
Lainhuutotiedot / rekisteriyksikkö
 		4,40 No VAT
8203
Rasitustiedot / rekisteriyksikkö
 		4,40 No VAT
8204
Vuokraoikeustiedot / rekisteriyksikkö
 		4,40 No VAT
8201
Laitoksen perustiedot / rekisteriyksikkö
 		0,30 No VAT
8205
Yhteystiedot / rekisteriyksikkö
 		2,00 No VAT
8241
Rekisteriyksiköiden haku hakuehdoin / haku
 		0,30 No VAT
8242
Määräalojen haku hakuehdoin / haku
 		0,30 No VAT
8243
Laitosten haku hakuehdoin / haku
 		0,30 No VAT
8201355
Perustiedot
 		0,30 No VAT
8208
Lainhuutotiedot, ilman henkilötietoja
 		4,40 No VAT
8209
Lainhuutotiedot, ilman henkilötunnusta
 		4,40 No VAT
8206
Laitoksen perustiedot, ilman henkilötietoja
 		0,30 No VAT
8207
Laitoksen perustiedot, ilman henkilötunnusta
 		0,30 No VAT
8210
Rasitustiedot, ilman henkilötietoja
 		4,40 No VAT
8211
Rasitustiedot, ilman henkilötunnusta
 		4,40 No VAT
8212
Vuokraoikeustiedot, ilman henkilötietoja
 		4,40 No VAT
8213
Vuokraoikeustiedot, ilman henkilötunnust
 		4,40 No VAT

Rajapintapalvelun käyttöönotto edellyttää sopimusta Maanmittauslaitoksen kanssa sekä KTJ-lain (Laki kiinteistötietojärjestelmästä) mukaista käyttölupaa. Palvelun käyttölupa myönnetään hakemuksen perusteella. Käyttölupa voidaan myöntää, mikäli tietoja tarvitaan

  • yhdyskuntasuunnittelua,
  • kiinteistönvälitystä,
  • luoton myöntämistä tai valvontaa tai
  • muuta näihin verrattavaa kiinteistöihin liittyvää tarkoitusta varten.

Käyttölupaa ei voida myöntää suoramarkkinointiin tai muuhun vastaavaan toimintaan. Suuri osa viranomaisista saa palvelun käyttöönsä ilman lupamenettelyä.

Käyttöönotto

  1. Ota yhteyttä sähköpostitse verkkopalveluiden asiakastukeen osoitteeseen verkkopalvelut(at)maanmittauslaitos.fi. Kirjoita viestiin millaisessa sovelluksessa ja käyttötarkoituksessa kiinteistötietoja on tarkoitus käyttää. 
  2. Asiakastuki toimittaa sinulle hakemuslomakkeen ja tietoturvaliitteen täytettäväksi. Samalla hakemuksella voit hakea myös Kiinteistötietojen tulostepalvelun käyttöoikeutta.
  3. Harkitsemme käyttöluvan myöntämistä tapauskohtaisesti hakemuksessa ja tietoturvaliitteessä annettujen tietojen pohjalta. Tarvittaessa pyydämme lisätietoja. 
  4. Jos luvan ehdot täyttyvät, toimitamme sopimuksen tutustuttavaksi ja allekirjoitettavaksi. Sopimukset ovat määrämuotoisia ja toistaiseksi voimassa olevia.
  5. Sopimuksen solmimisen jälkeen Maanmittauslaitos luovuttaa asiakasorganisaatiolle käyttäjätunnuksen (palvelutunnuksen) ja salasanan. Tunnus-salasanayhdistelmä tulee tallentaa asiakkaan sovellukseen niin, että sovelluksen loppukäyttäjä ei saa sitä tietoonsa missään vaiheessa.

Ota huomioon tietoturva- ja tietosuojavaatimukset

Lupa ja sopimus edellyttävät tietoturva- ja tietosuojavaatimusten täyttämistä. Tietoturvaliitteessä kysymme mm. miten organisaatiossanne hoidetaan tämän palvelun osalta:

  • henkilötietojen käsittely, 
  • organisaation käyttäjä- ja pääsynhallinta ja
  • KTJ-tietojen haun lokitus.

Käyttäjähallinta

Asiakasorganisaation tulee järjestää tietojen käyttäjille käyttäjähallinta. Käyttäjien oikeudet luvanvaraisiin tietoihin tulee pitää ajantasalla. Käyttöoikeudet palveluun saa olla vain niillä henkilöillä, jotka työtehtäviensä perusteella tarvitsevat luvanvaraisia kiinteistötietoja. Käyttöoikeudet täytyy sulkea esimerkiksi työsuhteen päättyessä tai työtehtävien vaihtuessa. 

Tietojen käytön lokitus

Organisaation tulee järjestää tietojen haun lokitus ja lokien säilytys. Lokitiedoista tulee käydä ilmi, kuka henkilö on hakenut tietoja, mitä tietoja ja milloin.

Lokien säilytyksen lisäksi lokitiedot täytyy toimittaa Maanmittauslaitokselle. Ensisijaisesti toivomme, että toimitatte loppukäyttäjätiedon jokaisessa rajapintakyselyssä. 

Voit testata Kiinteistötietojen kyselypalvelua (REST) koekäyttöpalvelussa maksutta. Tutustu koekäyttöpalvelun kuvaukseen. 

Koekäyttöpalvelun tuotteet ja kyselyt ovat samoja mitä tuotantoympäristössä, mutta data on staattinen kopio lainhuuto- ja kiinnitysrekisterin tilanteesta. Juridisten ja luonnollisten henkilöiden tiedot eivät ole todellisia.

Palvelun käyttöön tarvitaan koekäyttölupa ja käyttäjätunnus. Ota yhteyttä verkkopalveluiden asiakastukeen: verkkopalvelut@maanmittauslaitos.fi. Kirjoita viestiin

  • millaista palvelua olet suunnittelemassa
  • millaiseen käyttötarkoitukseen tuotantopalvelun tietoja on tarkoitus hyödyntää ja
  • kuka tietoja käyttää.

Koekäyttöpalvelun käyttöön myönnetään lupa, joka on voimassa kuusi kuukautta. Testaus on maksutonta.

Koekäyttö on tarkoitettu vain tekniseen testaamiseen. Oikeiden ja ajantasaisten tietojen hyödyntäminen edellyttää tuotantosopimuksen laatimista (katso kohta Ota käyttöösi).

 

Tuki

Rajapinnan tekninen tuki palvelee ma - pe klo 8 - 16. Saat tukeen yhteyden verkkolomakkeella.

Sopimuksiin ja käyttäjätunnuksiin liittyvää tukea saat osoitteesta verkkopalvelut@maanmittauslaitos.fi. 

Mahdollisista häiriöistä ilmoitetaan sovellusinfossa. Palveluun tehtävistä muutoksista tiedotetaan Palvelutiedotteet -verkkosivuilla. 

Voit antaa palautetta ja kehitysehdotuksia lomakkeen kautta.

Tutustu myös näihin

Kiinteistötietojen tulostepalvelu

Kiinteistötietojen tulostepalvelu tarjoaa ajantasaisia kiinteistörekisterin sekä lainhuuto- ja kiinnitysrekisterin otteita ja tulosteita.

Read more

Kiinteistötietojen kyselypalvelu (OGC API Features)

Palvelusta saat käyttöösi kiinteistörajat, kiinteistötunnukset ja rajamerkit sijaintitietoineen, sekä palstan, rekisteriyksikön ja määräalan keskeisiä tietoja. Palvelusta saa myös tietoja käyttöoikeusyksiköistä, joiden sijainti on tallennettu kiinteistörekisteriin. Käyttöoikeusyksiköitä ovat mm. tieoikeudet, luonnonsuojelualueet yksityisten omistamilla alueilla ja voimansiirtolinjat. Lisäksi palvelusta on saatavissa myös kunnan rekisterinpitoalueiden sijainnit.

Read more

Application and service status

Check the status and any disturbances of applications and online services.

Sovellusinfo

Customer service of the web services

Customer support for web service is provided in matters concerning agreements and licences. Contact customer service: verkkopalvelut@maanmittauslaitos.fi or 029 530 1119.

Problems using the service?

Contact our technical support.