X-tee teenuste kasutamiseks peab olema X-tee liige ja üles seatud turvaserver.
Avalikud teenused on toodud välja kõikide teenuste juures, mille kasutamiseks ei pea taotlema ligipääsu, vaid piisab, kui Teie asutus on liitunud X-tee EE keskkonnaga.
Avalike teenuste kasutamise puhul nõustute MTP andmeteenuste kasutustingimustega
Enamus maatoimingute platvormi X-tee teenustest on piiratud ligipääsuga, mille kasutamiseks peab taotlema ligipääsu.
Kui teenus ei ole avalik, siis tuleb täita järgnev taotlus ning saata digiallkirjastatuna aadressile [email protected]
Allalaadimiste puhul võivad muutuda linkide asukohad või struktuur, kui soovite saada teadet muudatuste kohta, siis palun täitke allolev vorm:
Maatoimingute platvormi X-tee ja API teenused
Tähelepanu! Anname teada, et seoses uue katastri süsteemi arendamisega on muutunud maakatastri X-tee teenused. Katastriteenustel lõppes andmete uuenemine ja need asendati uue MTP-Kataster alamsüsteemi teenustega. Andmete uuenemine vanades teenustes lõppes 29. märtsil 2024.
MTP-Kataster alamsüsteem (X-tee ja API)
Uued teenused cadastral-data ja cadasteCode on arendatud X-tee REST protokollis ning on saadaval üle X-tee või otse API kaudu. Nendele teenustele WSDL ei esitata, vaid on olemas OpenAPI spetsifikatsioonid dev, test ja live keskkondades:
https://x-tee.ee/catalogue/EE/GOV/70003098/mtp-kataster
Teenused /cadastral-data ja /valid on kõigile X-tee'ga liitunud alamsüsteemidel dev, test ja live keskkondades avatud. Allpool on toodud teenuste spetsifikatsioonid, milles on saadaval näidispäringu struktuur. Kui vajate abi päringu koostamisega, siis võtke ühendust [email protected].
Kui võtate kasutusele katastri API teenused ning teete igapäevaselt suurel hulgal päringuid, siis palume endast teada anda kirjutades [email protected].
Lisaks saab lugeda X-tee REST protokolli ja täiendavate spetsifikatsioonide kohta siit: https://blog.ria.ee/x-road-rest-tugi/
Teenused:
/xroad/cadastral-data
Teenus tagastab katastriüksuste muudatuse logi, asendab MIS-i teenust kylogi/v1.
Teenuste spetsifikatsioon (sisaldab näidispäringut, andmeväljade selgitusi, päringu sisendi parameetreid jne) -
Toimingute vastavused -
X-tee näidispäring LIVE keskkonnas (POST):
-- asendada enda asutusega seotud infoga --
curl --insecure \
--cert "-- turvaserveri kliendi alamsüsteemi sertifikaat --" \
--key "-- turvaserveri kliendi alamsüsteemi privaatvõti --" \
--location "https://--asutuse turvaserveri aadress--/EE/GOV/70003098/mtp-kataster/xroadservices/xroad/cadastral-data" \
--header "Content-Type: application/json" \
--header "Accept: */*" \
--header "X-Road-Client: --asutuse alamsüsteem formaadis „keskkond/liikmeklass/registrikood/alamsüsteem-- " \
--header "X-Road-Id: --x-tee päringu unikaalne identifikaator nt UUID formaadis-- " \
--data '{"id" : "-1"}'
API näidispäring LIVE keskkonnas (POST):
curl -X 'POST' \
'https://cadastrepublic.kataster.ee/api/xroad/cadastral-data' \
-H 'accept: */*' \
-H 'Content-Type: application/json' \
-d '{
"id": -1,
"algkuupaev": "2024-04-11T07:34:02.508Z",
"loppkuupaev": "2024-04-11T07:34:02.508Z",
"ay_kood": "string",
"ov_kood": "string",
"mk_kood": "string",
"tunnus": "string",
"mis_muutused": "string"
}'/xroad/valid{cadastreCode}
Teenuse asendab MIS alamsüsteemi teenust kytunnus.v1. Tegemist on GET päringuga. Teenus võimaldab pärida katastriüksuse tunnuse põhjal infot antud üksuse kohta.
Teenuste spetsifikatsioon (sisaldab näidispäringut, andmeväljade selgitusi, päringu sisendi parameetreid jne) -
X-tee näidispäring LIVE keskkonnas (GET):
-- asendada enda asutusega seotud infoga --
curl --insecure \
--cert "-- turvaserveri kliendi alamsüsteemi sertifikaat --" \
--key "-- turvaserveri kliendi alamsüsteemi privaatvõti --" \
--location "https://--asutuse turvaserveri aadress--/EE/GOV/70003098/mtp-kataster/xroadservices/xroad/valid /79501%3A027%3A0011" \ --katastriüksuse tunnus määrata teenuse parameetrina--
--header "Content-Type: application/json" \
--header "Accept: */*" \
--header "X-Road-Client: --asutuse alamsüsteem formaadis „keskkond/liikmeklass/registrikood/alamsüsteem-- " \
--header "X-Road-Id: --x-tee päringu unikaalne identifikaator nt UUID formaadis-- " \
API näidispäring LIVE keskkonnas (GET):
CURL:
curl -X 'GET' \
'https://cadastrepublic.kataster.ee/api/xroad/valid/79501%3A027%3A0011' \
-H 'accept: */*'URL: https://cadastrepublic.kataster.ee/api/xroad/valid/79501%3A027%3A0011
MIS alamsüsteem (X-tee)
MIS X-tee teenustes on lõppenud andmete uuenemine seisuga 29.märts 2024 (v.a ehak ja tehingud, kus andmeid uuendati kuni 18.august 2026). MIS x-tee teenused eemaldati turvaserverist 2026.a. oktoobris.
MAAOK alamsüsteem (X-tee)
MAAOK X-tee teenusega on võimalik oksjoneid lisada, muuta, kustutada ja otsida. MAAOK on registreeritud ka RIHA-s ja teenused (WSDL) on kirjeldatud ka X-tee kataloogis.
MAAOK X-tee teenused:
- klassifikaatorid/v1
- oksjoniLisamine/v1
- oksjoniMuutmine/v1
- oksjoniObjektiKatkestamine/v1
- oksjoniObjektiOtsing/v1
- maaok/rkSendMessageIso/v1
KPOIS alamsüsteem (X-tee)
Kitsenduste X-tee teenus võimaldab pärida kitsendusi põhjustavaid objekte, kitsenduste mõjualasid, kitsendusi kustutada, lisada, muuta, pärida kitsendusekaardi linki või trükist ning maamaksu soodustuse vööndi suurust. KPOIS on registreeritud ka RIHA-s ja teenused (WSDL) on kirjeldatud ka X-tee kataloogis.
KPOIS X-tee teenused:
- kyKitsendused/v2
- kyKitsendusedAvalik/v2
- kpois/kyKitsendusedKustutamine/v1
- kyKitsendusedLisamineMuutmine/v1
- kyKitsendusteLink/v1
- kyKitsendusteTrykis/v2
- kyMaamaksuSoodustused/v1
- kyKpo/v2
NB! kyKitsendusedAvalik ei tagasta I ja II kaitsekategooria objekte, kyKitsendused tagastab.
Tiheasustusalad alamsüsteem (X-tee)
Tiheasustusalade X-tee teenus võimaldab pärida tiheasustusala olemasolu etteantud katastriüksuses või ruumikujus ja ka tiheasustusalade raportit. Teenused (WSDL) on kirjeldatud ka X-tee kataloogis. Spetsifikatsioon on koostamisel.
Tiheasustusalade X-tee teenused:
loeTiheasustusAladeRaport/v1
tiheasustusAla/v1
tiheasustusAladeRaport/v1
Kõlvikute API teenus
Kõlvikute rakenduses on välja arendatud API teenused, mille kaudu saab pärida kõlvikulist koosseisu nii katastriüksuse kui ka geomeetria järgi. NB! Kõlvikute rakendus ei paku 2024. aastast vanemaid andmeid.
Teenused:
GET /api/cadastre-unit/find
Teenusest saab leida kuupäeva ja tunnuse abil infot katastriüksuse ja selle kõlvikulise koosseisu kohta.
Päringu otspunkt ja parameetrid:
https://kolvikud.kataster.ee/api/cadastre-unit/find?date={kuupaev}&code={tunnus}
{kuupaev} täitmiseks tuleb sisestada kuupäev järgmises formaadis yyyy-mm-dd (aasta-kuu-päev). NB! Kõlvikute rakendus ei paku 2024. aastast vanemaid andmeid.
{tunnus} kohale läheb katastriüksuse tunnus.
Näidispäring:
https://kolvikud.kataster.ee/api/cadastre-unit/find?date=2024-02-01&code=79501:027:0011
POST /api/land-parcel/by-geometry
Teenuse kaudu on võimalik pärida kuupäeva ja WKT geomeetria abil infot kõlvikulise koosseisu kohta.
Päringu otspunkt ja parameetrid:
https://kolvikud.kataster.ee/api/land-parcel/by-geometry
{date} - kuupäev formaadis yyyy-mm-dd (aasta-kuu-päev).
{geometry} - geomeetria WKT formaadis
Näidispäring:
{
"date": "2024-03-22",
"geometry": "POLYGON ((658365.01 6474203.05, 658351.19 6474183.33, 658340.38 6474178.66, 658323.9 6474171.84, 658325.94 6474166.93, 658332.47 6474150.69, 658343.71 6474155.17, 658349.3 6474157.38, 658363.33 6474162.94, 658371.32 6474162.07, 658382.63 6474166.35, 658371.34 6474191.77, 658365.01 6474203.05))"
}
curl -X POST "https://kolvikud.kataster.ee/api/land-parcel/by-geometry"
-H "accept: application/json"
-H "Content-Type: application/json"
-d "{\"date\":\"2024-03-22\",\"geometry\":\"POLYGON ((658365.01 6474203.05, 658351.19 6474183.33, 658340.38 6474178.66, 658323.9 6474171.84, 658325.94 6474166.93, 658332.47 6474150.69, 658343.71 6474155.17, 658349.3 6474157.38, 658363.33 6474162.94, 658371.32 6474162.07, 658382.63 6474166.35, 658371.34 6474191.77, 658365.01 6474203.05))\"}"
Maa korralise hindamise infosüsteemi (MKHIS) API teenused
Maa korralise hindamise API teenuste kaudu on võimalik pärida katastriüksuste kohta kehtivat maksustamishinda ehk maa väärtust.
Teenused:
POST /api/x-road/mkhis-log
Teenusest saab ISO formaadis oleva kuupäeva ja kellaaja alusel pärida kõik sellest hetkest uue maksustamishinna saanud katastritunnused.
Päringu otspunkt:
https://hindamine.kataster.ee/api/x-road/mkhis-log
Näide:
2024-02-27T11:32:27.6176079+02:00
POST /api/x-road/mkhis-detailed
Teenuse kaudu on võimalik pärida andmeid maatüki tunnuse või maatüki tunnuse ja kuupäeva põhjal. Kui sisendiks on ainult tunnus, tagastatakse hetkel kehtiv väärtus. Kui sisendiks anti ka kuupäev, tagastab teenus maa väärtuse selle kuupäeva seisuga.
Päringu otspunkt:
https://hindamine.kataster.ee/api/x-road/mkhis-detailed
Näide:
{
"cadastreId": "79501:027:0011",
"validDate": "2024-02-29"
}
POST /api/x-road/mkhis-detailed-by-batch
Teenuse kaudu on võimalik pärida hetkel kehtivaid maksustamishindu katastritunnusete alusel. Teenus võimaldab küsida tulemusi kuni 1000 kaupa korraga.
Päringu otspunkt:
https://hindamine.kataster.ee/api/x-road/mkhis-detailed-by-batch
Näide:
[
"79501:027:0011",
"78407:701:6840"
]
EHAK andmevahetusteenused (X-tee)
MIS alamsüsteemi EHAK andmevahetusteenused võimaldavad pärida haldus- ja asustusüksuste kehtivat seisu ja muudatusi. Seoses vana EHAK menetlussüsteemi sulgemisega uuendati allolevaid X-tee teenuseid septembris 2026. Vanad teenused asendusid uute REST API teenustega, mille spetsifikatsiooni leiate allpool.
Kehtivad EHAK X-tee teenused:
ehakkehtiv/v1 → asendatud teenusega X-tee teenusega active
ehaklogi/v1 → asendatud X-tee teenusega log
*ehaklogikompl/v1 → teenus lõpetati september 2026 ja see ei asendunud
Teenuste spetsifikatsioon:
Statistika API teenus
Statistikarakenduses statistika.kataster.ee välja arendatud API teenused, mille kaudu saab pärida kinnisvaratehingute ja katastriükuste koondstatistikat. Teenused annavad sama tulemuse, mis on näha rakenduses.
Üldine
- Kõik teenused on GET-päringud, vastus on JSON-massiiv.
- Mitu koodi eraldatakse komaga, nt mkKood=0037,0079.
- Kui väärtus on konfidentsiaalsuse tõttu peidetud, on vastuses „peidetud“: true ning pindala ja väärtus on null.
- Arvud võivad vastuses olla tekstina (nt „kogupind“: „11615.1“).
Teenused:
GET /api/tehingud/yldine
Teenusest saab tehingute üldstatistika: tehingute arv, kogupind ja koguväärtus valitud aruande, piirkonna ja ajavahemiku kohta.
Päringu otspunkt ja parameetrid:
https://statistika.kataster.ee/api/tehingud/yldine?statistikaLiik={statistikaLiik}&aastast={aastast}&kuust={kuust}&aastani={aastani}&kuuni={kuuni}&mkKood={mkKood}
| Parameeter | Kohustuslik | Kirjeldus |
| statistikaLiik | jah | Aruanne: tehingu_liik (tehinguliikide kaupa), myyja_liik (võõrandajate järgi), ostja_liik (omandajate järgi), sihtotstarve (sihtotstarvete järgi), tervikutingimus (kinnistu osade kaupa), kuudekaupa (kuude lõikes), mk_kood (maakondade kaupa). |
| aastast, kuust, aastani, kuuni | jah | Ajavahemiku algus- ja lõppaasta ning kuu (1–12). |
| mkKood | ei | Maakonnakoodid, nt 0037 (Harju maakond). Tühi = kogu Eesti. |
| ovKood | ei | Omavalitsuse, linna või linnaosa koodid, nt 0784 (Tallinn). |
| asumKood | ei | Küla, asumi või omavalitsuse sisese linna koodid. |
| tehinguLiik | ei | OSTM = ainult ost-müügitehingud; tühi = kõik tehingud. |
| piirkondId | ei | Aruandluspiirkond 1–8 (vt „Aruandluspiirkonnad“). |
| perioodid | ei | Mitu perioodi korraga (vt „Mitu perioodi ühe päringuga“). |
Näidispäringud:
Tehingud tehinguliikide kaupa, kogu Eesti, 2025:
Tehingud tehinguliikide kaupa, Harju ja Tartu maakonnas:
Ainult ost-müügid omandajate järgi, Tartu maakond:
Kinnisasja tehingud sihtotstarvete järgi Tallinna linnaosades:
GET /api/tehingud/objektiliik
Teenusest saab tehingud objekti liigi järgi (kinnisasi, hoonestamata ja hoonestatud maa, korteriomand ja hoonestusõigus).
Päringu otspunkt ja parameetrid:
https://statistika.kataster.ee/api/tehingud/objektiliik?aastast={aastast}&kuust={kuust}&aastani={aastani}&kuuni={kuuni}&mkKood={mkKood}
| Parameeter | Kohustuslik | Kirjeldus |
| aastast, kuust, aastani, kuuni | jah | Ajavahemiku algus- ja lõppaasta ning -kuu (kuud 1–12). |
| mkKood | ei | Maakonnakoodid, nt 0037 (Harju maakond). Tühi = kogu Eesti. |
| ovKood | ei | Omavalitsuse, linna või linnaosa koodid, nt 0784 (Tallinn). |
| asumKood | ei | Küla, asumi või omavalitsuse sisese linna koodid. |
| tehinguLiik | ei | OSTM = ainult ost-müügitehingud; tühi = kõik tehingud. |
| piirkondId | ei | Aruandluspiirkond 1–8 (vt „Aruandluspiirkonnad“). |
| perioodid | ei | Mitu perioodi korraga (vt „Mitu perioodi ühe päringuga“). |
Näidispäring:
Tehingud objekti liigi järgi, Tartu maakond, 2025:
GET /api/tehingud/residentsus
Teenusest saab tehingud omandajate või võõrandajate residentsuse (riigi) kaupa. Andmed alates 2008. aastast.
Päringu otspunkt ja parameetrid:
https://statistika.kataster.ee/api/tehingud/residentsus?osaleb={osaleb}&aastast={aastast}&kuust={kuust}&aastani={aastani}&kuuni={kuuni}&mkKood={mkKood}
| Parameeter | Kohustuslik | Kirjeldus |
| osaleb | jah | O = omandajad, M = võõrandajad. |
| aastast, kuust, aastani, kuuni | jah | Ajavahemiku algus- ja lõppaasta ning -kuu (kuud 1–12). |
| mkKood | ei | Maakonnakood(id), nt 0037 (Harju maakond). Tühi = kogu Eesti. |
| ovKood | ei | Omavalitsuse, linna või linnaosa kood(id), nt 0784 (Tallinn). |
| asumKood | ei | Küla, asumi või omavalitsuse sisese linna kood(id). |
| tehinguLiik | ei | OSTM = ainult ost-müügitehingud; tühi = kõik tehingud. |
| piirkondId | ei | Aruandluspiirkond 1–8 (vt „Aruandluspiirkonnad“). |
| perioodid | ei | Mitu perioodi korraga (vt „Mitu perioodi ühe päringuga“). |
Näidispäring:
Tehingud omandajate residentsuse kaupa, kogu Eesti, 2025:
GET /api/tehingud/hinnad
Teenusest saab hinnastatistika: tehingute arv, pindala, summa ning hinna ja ühikuhinna miinimum, mediaan, keskmine ja maksimum.
Päringu otspunkt ja parameetrid:
https://statistika.kataster.ee/api/tehingud/hinnad?statistikaLiik={statistikaLiik}&aastast={aastast}&kuust={kuust}&aastani={aastani}&kuuni={kuuni}&mkKood={mkKood}&loikeAlt={loikeAlt}&loikeYlevalt={loikeYlevalt}
| Parameeter | Kohustuslik | Kirjeldus |
| statistikaLiik | jah | Aruanne: metsamaa, haritav_maa, hoonestatud_maa, hoonestamata_maa, korteriomand, ehitise_liik, eluhooned_konstruktsioon, eluhooned_ehitusaasta, korterid_konstruktsioon, korterid_ehitusaasta. |
| aastast, kuust, aastani, kuuni | jah | Ajavahemiku algus- ja lõppaasta ning -kuu (kuud 1–12). |
| mkKood | ei | Maakonnakood(id), nt 0037 (Harju maakond). Tühi = kogu Eesti. |
| ovKood | ei | Omavalitsuse, linna või linnaosa kood(id), nt 0784 (Tallinn). |
| asumKood | ei | Küla, asumi või omavalitsuse sisese linna kood(id). |
| loikeAlt, loikeYlevalt | ei | Lõikeprotsent 0, 5, 10 … 50: jätab välja vastava osa odavaimaid ja kalleimaid tehinguid ühikuhinna järgi. Vaikimisi 0. |
| grupeeri | ei | False (vaikimisi) = tulemus iga koodi kohta eraldi; true = kõik koodid üheks koondiks. |
| valistus | ei | Linnad = jäta välja linnad; tallinn = jäta välja Tallinn. |
| perioodid | ei | Mitu perioodi korraga. |
NB! Korteriomandi andmed on alates 19.07.2003, ehitisregistril põhinevad aruanded alates 01.07.2003.
Näidispäringud:
Korteriomandite hinnad Tallinnas, 2025:
Korteriomandite hinnad 5% lõikega alt ja ülevalt, Harju ja Tartu maakonna kaupa:
Hoonestamata maa hinnad aastate kaupa 2023–2025, Tartu linn:
GET /api/kataster/regkat, /api/kataster/kykolvik, /api/kataster/kysiht
Teenustest saab katastriüksuste statistika valitud kuu seisuga: regkat – katastriüksuste arv ja pindala; kykolvik – kõlvikud (haritav maa, rohumaa, mets, õuemaa, muu); kysiht – sihtotstarbed (elamumaa, ärimaa, tootmismaa jne).
Päringu otspunkt ja parameetrid:
https://statistika.kataster.ee/api/kataster/regkat?aasta={aasta}&kuu={kuu}&mkKood={mkKood}&ovKood={ovKood}&asulaKaupa={asulaKaupa}
| Parameeter | Kohustuslik | Kirjeldus |
| aasta, kuu | jah | Seisu aasta ja kuu. |
| mkKood, ovKood | ei | Maakonna ja omavalitsuse koodid. |
| hkood | ei | Asula koodid. |
| asulaKaupa | ei | True = tulemus asulate kaupa. |
Näidispäringud:
Katastri registristatistika Harju maakonna kohta, detsember 2025:
https://statistika.kataster.ee/api/kataster/regkat?aasta=2025&kuu=12&mkKood=0037
Kõlvikud Tartu maakonnas, detsember 2025:
https://statistika.kataster.ee/api/kataster/kykolvik?aasta=2025&kuu=12&mkKood=0079
Sihtotstarbed Elva valla asulate kaupa:
Koodide leidmine
Maakondade, omavalitsuste, asumite ja aruandluspiirkondade koodid saab järgmistest teenustest:
- GET /api/tehingud/filter/aastad – aastad, mille kohta on andmeid: https://statistika.kataster.ee/api/tehingud/filter/aastad
- GET /api/tehingud/filter/maakonnad – maakonnad: https://statistika.kataster.ee/api/tehingud/filter/maakonnad
- GET /api/tehingud/filter/omavalitsused?mkKood={mkKood} – omavalitsused, linnad ja linnaosad: https://statistika.kataster.ee/api/tehingud/filter/omavalitsused?mkKood=0037
- GET /api/tehingud/filter/asumid?ovKood={ovKood} – külad, asumid ja omavalitsuse sisesed linnad: https://statistika.kataster.ee/api/tehingud/filter/asumid?ovKood=0784
- GET /api/tehingud/filter/piirkonnad – aruandluspiirkonnad: https://statistika.kataster.ee/api/tehingud/filter/piirkonnad
GET /api/kataster/filter/aastad, /maakonnad, /omavalitsused, /asulad – sama katastri kohta; maakondadel, omavalitsustel ja asulatel lisaks parameeter kuupaev (aasta-kuu-päev).
Aruandluspiirkonnad
{piirkondId}: 1 – Eesti, 2 – Eesti ilma Tallinnata, 3 – Põhja-Eesti, 4 – Kesk-Eesti, 5 – Kirde-Eesti, 6 – Lääne-Eesti, 7 – Lõuna-Eesti, 8 – kõik maakonnad v.a linnad.
Näidispäring:
Aruandluspiirkond Põhja-Eesti:
Mitu perioodi ühe päringuga
Parameetriga {perioodid} saab ühe päringuga kuni 12 perioodi. Periood kirjutatakse kujul AAAAKK-AAAAKK ja perioodid eraldatakse komaga. Lubatud on üks kuu (nt 202503-202503), kvartal (nt 202504-202506) või terve aasta (nt 202501-202512). Ajavahemik {aastast}…{kuuni} peab katma kõik perioodid. Vastuse ridadel on väli „periood“.
Näidispäring:
Mitu perioodi korraga: 2025 kvartalite kaupa, Harju maakond:
Piirangud ja veateated
Vigase päringu korral vastab teenus veaga 400 ja selgitava tekstiga:
- kohustuslikud parameetrid puuduvad;
- koode üle 250 parameetri kohta (katastris üle 1000);
- lõikeprotsent ei ole 0, 5, 10 … 50;
- perioode üle 12 või vale kujuga periood;
- hinnastatistikas koodide arv × perioodide arv üle 250.
Päring, mis kestab üle 30 sekundi, katkestatakse. Suure päringu korral tuleb see väiksemateks jagada.
Näidispäring:
Vigane periood (5 kuud) annab vea 400:
Viimati uuendatud 23.10.2026
