Tekninen kuvaus Kiinteistötietojen kyselypalvelun (REST) koekäyttöpalvelu

Kiinteistötietojen kyselypalvelun (REST) koekäyttöpalvelu tarjoaa mahdollisuuden testata lainhuuto- ja kiinnitysrekisterin tuotteita. Palvelu on suunniteltu tukemaan kehittäjiä ja organisaatioita Kiinteistötietojen kyselypalvelun (REST) käyttöönotossa.

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. Lisäksi koekäyttöpalvelu sisältää noin 1000 kuvitteellisen kiinteistön aineiston, jonka kuntatunnus on 988.

Koekäyttöpalvelu on käytettävissä 24/7.

Käyttöönotto

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ölupa on voimassa kuusi kuukautta ja testaus on maksutonta. Tuotantosopimuksen tehneillä on mahdollisuus saada pysyvä koekäyttötunnus.

Palveluosoitteet ja esimerkkejä kyselyistä löydät alla olevasta Kyselyt ja esimerkit -osiosta.

Koekäyttöpalvelussa on testattavissa kaikki tuotantopalvelun tuotteet. Hakujen suorittamiseen tarvitaan koekäyttöpalvelun käyttäjätunnus ja salasana. Tuotantopalvelun osoitteesta saa koekäyttöpalvelun osoitteen vaihtamalla osoitteen alkuun ktjws.nls.fi -> ktjwsint.nls.fi

Esimerkit

Alla on koottuna joitakin esimerkkihakuja lainhuuto- ja kiinnitysrekisterin tietoihin koekäyttöpalvelussa. Esimerkkien vastaukset on tallennettu staattisiksi tiedostoiksi niin, että pääset katsomaan vastaukset linkistä ilman käyttäjätunnusta.

Perustiedot

Lainhuutotiedot

Rasitustiedot

Vuokraoikeustiedot

Henkilön omistukset

Haku hakuehdoin

3D-tietoja sisältävät kohteet

Yhteiset testikiinteistöt eri koekäyttöpalveluissa

Perustiedot

Perustiedot kiinteistöstä

Esimerkki 990-3-6-1

  • Kyselyn URL: https://ktjwsint.nls.fi/ktjkir/kysely/perustiedot/kohde/xml?kohdetunnus=99800300060001
  • Katso vastaus (xml)

Perustiedot määräalasta

Esimerkki 998-429-1-932-M605

  • Kyselyn URL:
    https://ktjwsint.nls.fi/ktjkir/kysely/perustiedot/maaraala/kohde/xml?kohdetunnus=99842900010932M0605
  • Katso vastaus (xml)
     

Perustiedot laitoksesta 

Esimerkki  988-2-11-122-L1

  • Kyselyn URL:
    https://ktjwsint.nls.fi/ktjkir/kysely/perustiedot/laitos/kohde/xml?kohdetunnus=998-2-11-122-L1
  • Katso vastaus (xml) 

Lainhuutotiedot

Lainhuutotiedot sisältäen henkilötunnukset

Esimerkki 998-1-8-6 

  • Kyselyn URL: https://ktjwsint.nls.fi/ktjkir/kysely/lainhuutotiedot/xml?kohdetunnus=99800100080006
  • Katso vastaus (xml)
  • Kohteella kaksi omistajaa.
  • Voimassaolevat osuudet ½ A ja ½ B

Esimerkki 998-1-8-11

  • Kyselyn URL:
    https://ktjwsint.nls.fi/ktjkir/kysely/lainhuutotiedot/xml?kohdetunnus=99800100080011
  • Katso vastaus (xml)
  • Kohteen omistus on määräosina. Kohteen voimassaolevat omistusosuudet:
    •  ½ omistaja A
    • 7/25 omistaja B
    • 1/25 omistaja C
    • osuuksien summa jää alle 1/1
  • Katso myös kohteen lainhuutotodistus (pdf).

Esimerkki 998-2-10-120

  • Kyselyn URL:
    https://ktjwsint.nls.fi/ktjkir/kysely/lainhuutotiedot/xml?kohdetunnus=99800200100120
  • Katso  vastaus (xml)
  • A omistanut koko kohteen (1/1) 
  • A luovuttanut koko kohteen B:lle
  • Voimassaoleva osuus 1/1, omistaja B
  • Katso myös kohteen lainhuutotodistus (pdf)
     

Esimerkki 998-2-10-121

  • Kyselyn URL: https://ktjwsint.nls.fi/ktjkir/kysely/lainhuutotiedot/xml?kohdetunnus=99800200100121
  • Katso vastaus (xml)
  • Kohteella omistus määräosin. Samalle omistajalle A on tapahtunut luovutuksia eri aikoina eri luovuttajilta.  Omistaja A on luovuttanut 1/500 osuuden B:lle
  • Voimassaolevat kohteen omistusosuudet.
    • A osuus ¼  
    • A osuus ¼ 
    • A osuus ¼ 
    • A osuus 2/500
    • B osuus 1/500
  • Katso myös kohteen lainhuutotodistus (pdf).

Esimerkki: 998-3-6-1

  • Kyselyn URL:
    https://ktjwsint.nls.fi/ktjkir/kysely/lainhuutotiedot/xml?kohdetunnus=99800300060001
  • Katso vastaus (xml)
  • voimassaoleva lainhuuto nykyinen omistaja A
  • lainhuudattamaton luovutus B:lle (kauppa)
  • uuden omistajan lainhuuto vireillä
  • Katso myös kohteen lainhuutotodistus (pdf)

Esimerkki 998-4-18-6

  • Kyselyn URL:
    https://ktjwsint.nls.fi/ktjkir/kysely/lainhuutotiedot/xml?kohdetunnus=99800400180006
  • Katso vastaus (xml)
  • voimassaoleva lainhuuto (kaksi nykyistä omistajaa)
  • kohteesta luovutettu uusi määräala
  • kohteella uuden omistajan lainhuuto vireillä määräalaan, jonka tunnus puuttuu
  • Katso lainhuutotodistus (pdf).
     

Esimerkki 998-3-29-6

  • Kyselyn URL:
    https://ktjwsint.nls.fi/ktjkir/kysely/lainhuutotiedot/xml?kohdetunnus=99800300290006
  • Katso vastaus (xml)
  • voimassaoleva lainhuuto (nykyinen omistaja)
  • kohteen uusi luovutus (uusi omistaja), luovutus ½ (puolet) kohteesta
  • kohteella uuden omistajan lainhuuto vireillä
  • Katso lainhuutotodistus (pdf).

Lainhuutotiedot ilman henkilötunnuksia

Esimerkki: 998-1-8-6

  • Kyselyn URL:
    https://ktjwsint.nls.fi/ktjkir/kysely/lainhuutotiedot_ilman_henkilotunnusta/xml?kohdetunnus=99800100080006
  • Katso vastaus (xml)
  • Kohteella kaksi omistajaa.
  • Kiinteistön on omistanut A kokonaan (1/1), josta luovutettu ½ uudelle saajalle B:lle. 
  • Voimassaolevat osuudet ½ A ja ½ B
     

Lainhuutotiedot ilman henkilötietoja

Esimerkki: 998-1-8-6

  • Kyselyn URL:
    https://ktjwsint.nls.fi/ktjkir/kysely/lainhuutotiedot_ilman_henkilotietoja/xml?kohdetunnus=99800100080006
  • Katso vastaus (xml)
     

Rasitustiedot

Rasitustiedot sisältäen henkilötunnukset

Esimerkki: 998-3-6-1

  • Kyselyn URL:
    https://ktjwsint.nls.fi/ktjkir/kysely/rasitustiedot/xml?kohdetunnus=99800300060001
  • Katso vastaus (xml)
  • kohteeseen kohdistuvat seuraavat rasitukset, henkilötunnukselliset tiedot
    • Muulle kuin kiinteistön omistajalle perustetut oikeudet
      • Erityinen oikeus: Vuokraoikeus, laitos (L1)
        • Erityisen oikeuden muutos vireillä
      • Erityinen oikeus: Vuokraoikeus, laitos (L3)
        • Erityisen oikeuden muutosasia vireillä (vuokraoikeuden siirto)
      • Erityinen oikeus: Vuokraoikeus, laitos (L4)
      • Erityinen oikeus: Muu käyttöoikeus
    • Kiinnitys, sähköinen panttikirja (siirretty uudelle omistajalle)
    • Kiinnitys, sähköinen panttikirja (siirretty uudelle omistajalle)
  • Katso myös kohteen rasitustodistus (pdf).

Esimerkki: 998-4-18-6

  • Kyselyn URL:
    https://ktjwsint.nls.fi/ktjkir/kysely/rasitustiedot/xml?kohdetunnus=99800400180006
  • Katso vastaus (xml)
  • kohteeseen kohdistuu kiinnitys, sähköisen panttikirja
  • Katso myös kohteen rasitustodistus (pdf).

Esimerkki 998-3-29-6

  • Kyselyn URL: 
    https://ktjwsint.nls.fi/ktjkir/kysely/rasitustiedot/xml?kohdetunnus=99800300290006
  • Katso vastaus (xml)
  • kohteeseen kohdistuvat seuraavat rasitukset
    • Muulle kuin kiinteistön omistajalle perustetut oikeudet
      • Erityinen oikeus: Vuokraoikeus, laitos (L2)
      • Erityinen oikeus: Muu käyttöoikeus
      • Kiinnitys, sähköisen panttikirjan saaja uusi omistaja (luovutuksen saaja)
  • Katso kohteen rasitustodistus (pdf).

Esimerkki: 998-2-11-122

  • Kyselyn URL: 
    https://ktjwsint.nls.fi/ktjkir/kysely/rasitustiedot/xml?kohdetunnus=99800200110122
  • Katso vastaus (xml).
  • Kohteella sijaitsee vuokraoikeus laitostunnuksella 998-2-11-122-L1
  • Vuokralainen A omistaa vuokraoikeuden (1/1)
  • Vuokralainen A luovuttaa vuokraoikeudesta ½  B:lle
  • Voimassaolevat vuokralaiset ovat: 
  • ½ vuokralainen A
  •  ½ vuokralainen B
  • Katso kohteen rasitustodistus (pdf).

Esimerkki: 998-401-3-15

  • Kyselyn URL: 
    https://ktjwsint.nls.fi/ktjkir/kysely/rasitustiedot/xml?kohdetunnus=99840100030015
  • Katso vastaus (xml)
  • kohteella on muistutusmerkintänä panttaamattomuussitoumus, muistutuslaji VA5201
     

Rasitustiedot ilman henkilötunnusta 

Esimerkki: 998-2-11-122

  • Kyselyn URL: 
    https://ktjwsint.nls.fi/ktjkir/kysely/rasitustiedot_ilman_henkilotunnusta/xml?kohdetunnus=99800200110122
  • Katso vastaus (xml)
     

Rasitustiedot ilman henkilötietoja

Esimerkki: 998-2-11-122

  • Kyselyn URL: 
    https://ktjwsint.nls.fi/ktjkir/kysely/rasitustiedot_ilman_henkilotietoja/xml?kohdetunnus=99800200110122
  • Katso vastaus (xml)
    https:\\xml.nls.fi\XML\Schema\sovellus\ktjkir\asiakasdokumentaatio\versionhallinta\8.1\esimerkit\kp_rasitustiedot\Rasitustiedot_ilman_henkilotietoja.xml


Vuokraoikeustiedot

Vuokraoikeustiedot sisältäen henkilötunnuksen

Esimerkki: 998-2-11-122-L1

  • Kyselyn URL: 
    https://ktjwsint.nls.fi/ktjkir/kysely/vuokraoikeustiedot/xml?kohdetunnus=998-2-11-122-L1
  • Katso vastaus (xml)
     

Vuokraoikeustiedot ilman henkilötunnusta

Esimerkki: 998-2-11-122-L1

  • Kyselyn URL: 
    https://ktjwsint.nls.fi/ktjkir/kysely/vuokraoikeustiedot_ilman_henkilotunnusta/xml?kohdetunnus=998-2-11-122-L1
  • Katso vastaus (xml)
     

Vuokraoikeustiedot ilman henkilötietoja

Esimerkki: 998-2-11-122-L1

  • Kyselyn URL: https://ktjwsint.nls.fi/ktjkir/kysely/vuokraoikeustiedot_ilman_henkilotietoja/xml?kohdetunnus=998-2-11-122-L1
  • Katso vastaus (xml)

Henkilön omistukset

Esimerkki: 290280-9044

  • Kyselyn URL: https://ktjwsint.nls.fi/ktjkir/kysely/omistustiedot/tunnus/xml?tunnus=290280-9044
  • Katso vastaus (xml)


Rekisteriyksiköiden haku hakuehdoin

Esimerkki: kiinteistötunnuksella 998-1-8-6

  • Kyselyn URL: 
    https://ktjwsint.nls.fi/ktjkir/kysely/perustiedot/rekisteriyksikko/kohde/xml?kohdetunnus=99800100080006
  • Katso vastaus (xml)

 

Esimerkki: muutostapahtumilla

  • Kyselyn URL:
    https://ktjwsint.nls.fi/ktjkir/kysely/perustiedot/rekisteriyksikko/muutos/xml?kunta=998&muutostapahtumalaji=102&muutospvmAlku=2024-05-01&muutospvmLoppu=2024-05-31
  • katso vastaus (xml)


Määräalojen haku hakuehdoin

Esimerkki: Määräalatunnuksella 988-2-11-123-M05501

  • Kyselyn URL: https://ktjwsint.nls.fi/ktjkir/kysely/perustiedot/maaraala/kohde/xml?kohdetunnus=99800200110123M0501
  • Katso vastaus (xml)

Esimerkki: muutostapahtumilla

  • Kyselyn URL:
    https://ktjwsint.nls.fi/ktjkir/kysely/perustiedot/maaraala/muutos/xml?kunta=998&muutostapahtumalaji=101&muutospvmAlku=2023-02-01&muutospvmLoppu=2023-02-28
  • Katso vastaus (xml)
     

Laitosten haku hakuehdoin

Esimerkki: laitostunnuksella 998-2-11-122-L1

  • Kyselyn URL:

    https://ktjwsint.nls.fi/ktjkir/kysely/perustiedot/laitos/kohde/xml?kohdetunnus=998-2-11-122-L1

  • Katso vastaus (xml)

    
Esimerkki: kiinteistötunnuksella 998-2-11-122

  • Kyselyn URL: https://ktjwsint.nls.fi/ktjkir/kysely/perustiedot/laitos/kohde/xml?kohdetunnus=998-2-11-122
  • Katso vastaus (xml)

Esimerkki: muutostapahtumilla

  • Kyselyn URL: https://ktjwsint.nls.fi/ktjkir/kysely/perustiedot/laitos/muutos/xml?kunta=998&muutostapahtumalaji=112&muutospvmAlku=2024-08-01&muutospvmLoppu=2024-08-31

Katso vastaus (xml)

 

3D-tietoja sisältävät kohteet

Koekäyttöpalvelun aineistossa on seuraavat 3D-tietoja sisältävät kohteet

Tontti, peruskiinteistön yläpuolinen,167-44-5-2

  • Tontti, peruskiinteistön alapuolinen, 167-44-5-3
  • Tila, jolla peruskiinteistön ylä- ja alapuolinen määräala, 167-436-5-7
  • Määräala, peruskiinteistön yläpuolinen, 167-436-5-7-M601
  • Määräala, peruskiinteistön alapuolinen, 167-436-5-7-M602
  • Laitos, jolla peruskiinteistön yläpuolinen sijaintikohde, 45-407-21-215-L1
  • Laitos, jolla peruskiinteistön alapuolinen sijaintikohde, 167-44-5-3-L1

Yhteiset testikiinteistöt koekäyttöpalveluissa

Koekäyttöpalvelun aineisto sisältää myös noin 1000 kiinteistön testiaineiston, joka löytyy myös Digi- ja väestötietoviraston ylläpitämästä testiaineistopalvelusta.  Testiaineistossa on käytetty testikuntatunnusta 998. Tuhannen kiinteistön joukossa on viisi kiinteistöä, joiden tiedot löytyvät Kiinteistötietojen kyselypalvelun (OGC AP Features) koekäyttöpalvelusta sijainnillisena.

Nämä kiinteistöt ovat:
• 998-503-4-3 (tila) 
• 998-3-27-1 (tontti)
• 998-3-27-2 (tontti)
• 998-3-27-3 (tontti)
• 998-3-27-4 (tontti)

Testiaineistopalvelu on Digi- ja väestötietoviraston, Patentti- ja rekisterihallituksen, Maanmittauslaitoksen sekä Verohallinnon yhteishanke.

Olet estänyt evästeet. Jos haluat antaa palautetta tästä sivusta, hyväksy kävijämittaus- ja analytiikkaevästeet.