Määruse jõustumisel muutuvad tegelike kasusaajate andmetele (Sh API päringule) ligipääsu nõuded. Loe täpsemalt tegelike kasusaajate andmetele ligipääsu muudatustest Rahandusministeeriumi pressiteatest ja e-äriregistri abiinfost
(uuendatud 02.07.2026)
Päringu nimi: arireg. tegelikudKasusaajad_v2
Lisainfo: Päring väljastab ühingu poolt esitatud tegelike kasusaajate info
XSD: https://www2.rik.ee/schemas/xtee6/arireg/test/xroad6_tegelikudKasusaajad_v2.xsd
Sisendparameetrid/otsingutingimused:
| Nimetus | Tähendus | Märkused |
|---|---|---|
| ariregister_kasutajanimi | Äriregistri kasutajanimi | Kohustuslik |
| ariregister_parool | Äriregistri parool | Kohustuslik |
| ariregistri_kood | Ettevõtja registrikood | Kohustuslik |
| paringuPohjendus | Päringu tegemise põhjendus | Valikuline |
| seosEttevottega | Päringu tegija seos ettevõttega | Valikuline |
| paringuTegija | Päringu tegija andmed | Valikuline plokk |
| paringuTegija.eesnimi | Päringu tegija eesnimi | Valikuline |
| paringuTegija.perekonnanimi | Päringu tegija perekonnanimi | Valikuline |
| paringuTegija.isikukoodiRiik | Päringu tegija isikukoodi riik | Riigi kood, nt EST |
| paringuTegija.isikukood | Päringu tegija isikukood | Valikuline |
| paringuTegija.synniaeg | Päringu tegija sünniaeg | Valikuline. Kasutatakse juhul, kui isikukoodi ei esitata. |
| ainult_kehtivad | Kas soovitakse ainult kehtivaid tegelikke kasusaajaid | Väärtus 1 või 0 ehk jah või ei. Vaikimisi 0. |
| keel | Vastuse keel | Valikuline. Näiteks est. |
NB! Päringu tegija alla tuleb lisada füüsilisest isikust kasutaja, kelle nimel päringut tehakse.
Väljundandmed:
- Kas ettevõtja on kohustatud esitama tegelikud kasusaajad
- Tegeliku kasusaaja eesnimi
- Tegeliku kasusaaja perenimi
- Tegeliku kasusaaja isikukood
- Tegeliku kasusaaja väliskood
- Tegeliku kasusaaja väliskoodi või sünnikoha riik
- Tegeliku kasusaaja väliskoodi või sünnikoha riik tekstina
- Tegeliku kasusaaja sünniaeg
- Tegeliku kasusaaja elukoha riik
- Tegeliku kasusaaja elukoha riik tekstina
- Tegeliku kasusaaja kontrolli teostamise viis
- Tegeliku kasusaaja kontrolli teostamise viis tekstina
- Tegeliku kasusaaja lõpetamise liik
- Tegeliku kasusaaja lõpetamise liik tekstina
- Tegeliku kasusaaja algus kuupäev
- lahknevusteade_esitatud - Tegeliku kasusaaja lahknevusmärke olemasolu
Näitepäring:
<?xml version="1.0" encoding="UTF-8"?>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:prod="http://arireg.x-road.eu/producer/">
<soapenv:Header/>
<soapenv:Body>
<prod:tegelikudKasusaajad_v2>
<prod:keha>
<!--Optional:-->
<prod:ariregister_kasutajanimi>XXXX</prod:ariregister_kasutajanimi>
<!--Optional:-->
<prod:ariregister_parool>XXXX</prod:ariregister_parool>
<prod:ariregistri_kood>10000000</prod:ariregistri_kood>
<!--Optional:-->
<prod:paringuPohjendus>Põhjendus</prod:paringuPohjendus>
<!--Optional:-->
<prod:seosEttevottega>Seos</prod:seosEttevottega>
<!--Optional:-->
<prod:paringuTegija>
<!--You may enter the following 5 items in any order-->
<prod:eesnimi>Mari</prod:eesnimi>
<prod:perekonnanimi>Maasikas</prod:perekonnanimi>
<prod:isikukoodiRiik>EST</prod:isikukoodiRiik>
<!--Optional:-->
<prod:isikukood>48512260277</prod:isikukood>
<!--Optional:-->
<prod:synniaeg>1985-11-10</prod:synniaeg>
</prod:paringuTegija>
<!--Optional:-->
<prod:ainult_kehtivad>True</prod:ainult_kehtivad>
<!--Optional:-->
<prod:keel>EST</prod:keel>
</prod:keha>
</prod:tegelikudKasusaajad_v2>
</soapenv:Body>
</soapenv:Envelope>
Näitevastus:
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ZSI="http://www.zolera.com/schemas/ZSI/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<SOAP-ENV:Header/>
<SOAP-ENV:Body xmlns:ns1="http://arireg.x-road.eu/producer/">
<ns1:tegelikudKasusaajad_v2Response>
<ns1:paring>
<ns1:ariregister_kasutajanimi>XXXX</ns1:ariregister_kasutajanimi>
<ns1:ariregister_parool>XXXX</ns1:ariregister_parool>
<ns1:ariregistri_kood>10000000</ns1:ariregistri_kood>
<ns1:paringuPohjendus>Põhjendus</ns1:paringuPohjendus>
<ns1:seosEttevottega>Seos</ns1:seosEttevottega>
<ns1:paringuTegija>
<ns1:eesnimi>Mari</ns1:eesnimi>
<ns1:perekonnanimi>Maasikas</ns1:perekonnanimi>
<ns1:isikukoodiRiik>EST</ns1:isikukoodiRiik>
<ns1:isikukood>48512260277</ns1:isikukood>
<ns1:synniaeg>1985-11-10Z</ns1:synniaeg>
</ns1:paringuTegija>
<ns1:ainult_kehtivad>true</ns1:ainult_kehtivad>
<ns1:keel>EST</ns1:keel>
</ns1:paring>
<ns1:keha>
<ns1:kasusaajad>
<ns1:kasusaajate_arv_kokku>2</ns1:kasusaajate_arv_kokku>
<ns1:peidetud_kasusaajate_arv>0</ns1:peidetud_kasusaajate_arv>
<ns1:lahknevusteade_puudumisest>false</ns1:lahknevusteade_puudumisest>
<ns1:kasusaaja>
<ns1:kirje_id>9000659846</ns1:kirje_id>
<ns1:eesnimi>Mari</ns1:eesnimi>
<ns1:nimi>Tamm</ns1:nimi>
<ns1:isikukood>47101010021</ns1:isikukood>
<ns1:aadress_riik>EST</ns1:aadress_riik>
<ns1:aadress_riik_tekstina>Eesti</ns1:aadress_riik_tekstina>
<ns1:kontrolli_teostamise_viis>K</ns1:kontrolli_teostamise_viis>
<ns1:kontrolli_teostamise_viis_tekstina>kaudne osalus</ns1:kontrolli_teostamise_viis_tekstina>
<ns1:algus_kpv>2018-09-03Z</ns1:algus_kpv>
<ns1:lahknevusteade_esitatud>true</ns1:lahknevusteade_esitatud>
</ns1:kasusaaja>
<ns1:kasusaaja>
<ns1:kirje_id>9000659847</ns1:kirje_id>
<ns1:eesnimi>JÜRI</ns1:eesnimi>
<ns1:nimi>KASK</ns1:nimi>
<ns1:isikukood>48001010022</ns1:isikukood>
<ns1:aadress_riik>EST</ns1:aadress_riik>
<ns1:aadress_riik_tekstina>Eesti</ns1:aadress_riik_tekstina>
<ns1:kontrolli_teostamise_viis>K</ns1:kontrolli_teostamise_viis>
<ns1:kontrolli_teostamise_viis_tekstina>kaudne osalus</ns1:kontrolli_teostamise_viis_tekstina>
<ns1:algus_kpv>2018-09-03Z</ns1:algus_kpv>
<ns1:lahknevusteade_esitatud>false</ns1:lahknevusteade_esitatud>
</ns1:kasusaaja>
</ns1:kasusaajad>
<ns1:esitab_kasusaajad>true</ns1:esitab_kasusaajad>
</ns1:keha>
</ns1:tegelikudKasusaajad_v2Response>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>