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. Tegelike kasusaajate andmeid edaspidi Detailandmete päringu kaudu ei saa. Õigustatud isikud saavad andmeid Tegelike kasusaajate API päringut kasutades.

Meetod: GET /company/{registryCode}/beneficialOwners

OpenAPI/Swagger: https://ar-rest.rik.ee/docs#/Company/get_company_beneficial_owners_company__registryCode__beneficialOwners_get

Tegelik kasusaaja on rahapesu ja terrorismi rahastamise tõkestamise seaduse (RahaPTS) § 9 lõike 1 kohaselt füüsiline isik, kellel on lõplik valitsev mõju füüsilise või juriidilise isiku üle või kelle huvides, kasuks või nimel tehing või toiming tehakse. Lõplik valitsev mõju tuleneb omandisuhtest või muul viisil teise isiku kontrollimise kaudu.

Teenus tagastab ettevõtte tegelike kasusaajate andmed, sealhulgas kasusaaja isikuandmed, kontrolli teostamise viisi, kehtivusperioodi ning lahknevusteadete info. Teenus toetab nii kehtivate kui ajalooliste kasusaajate päringut.

Täpsem juhis tegeliku kasusaaja tuvastamiseks: abiinfo.rik.ee juhis.

Juurdepääs ja andmete nähtavus

Tegelike kasusaajate andmete kuvamine sõltub päringu tegija juurdepääsuõigusest. Teenus kontrollib päringu tegija õigust ja tagastab andmed vastavalt määratud juurdepääsu ulatusele. Andmete vaatamine logitakse.

Juurdepääsu alus	Lühikirjeldus	Nähtavad andmed
Pädevad asutused	Kõrgeima ulatusega juurdepääs pädevatele asutustele, kellel on õigus näha tegelike kasusaajate andmeid oma ülesannete täitmiseks.	Nimi, isikukood, isikukoodi riik, sünniaeg, kontrolli teostamise viis, alguskuupäev, lõppkuupäev. Peidetud kasusaajate andmeid kuvatakse ainult eraldi õiguse olemasolul.
Kohustatud isikud	Juurdepääs kohustatud isikutele, kellel on vaja andmeid kasutada rahapesu ja terrorismi rahastamise tõkestamise seadusest tulenevate kohustuste täitmiseks. Enne andmete nägemist tuleb andmete vaatamist põhjendada.	Nimi, isikukood, isikukoodi riik, sünniaeg, kontrolli teostamise viis, alguskuupäev ja lõppkuupäev.
Õigustatud huvi	Piiratud juurdepääs kasutajale, kellel on tuvastatud õigustatud huvi. Lepinguline kasutaja peab andmete vaatamist põhjendama; vajadusel tuleb lisada ka seos päritava juriidilise isikuga. Ajakirjanduse/meedia ning MTÜ/teaduse kategooriate puhul võib seose täpsustamisel olla erand.	Nimi, sünniaeg, kontrolli teostamise viis, alguskuupäev ja lõppkuupäev.

Tee parameetrid

Parameeter	Tüüp	Kohustuslik	Kirjeldus
registryCode	integer	Kohustuslik	Ettevõtte registrikood. Registrikood on üldjuhul 8-kohaline numbriline kood.

Päringu parameetrid

Parameeter	Tüüp	Kohustuslik	Kirjeldus
queryReason	string	Valikuline	Tegelike kasusaajate andmete pärimise põhjus. Sõltuvalt päringu tegija juurdepääsu alusest võib seda kasutada andmetele juurdepääsu põhjendamiseks.
connectionToCompany	string	Valikuline	Seos ettevõttega, mille tegelike kasusaajate andmeid päritakse.
firstName	string	Kohustuslik	Päringu teinud isiku eesnimi.
lastName	string	Kohustuslik	Päringu teinud isiku perekonnanimi.
birthday	string (date) | null	Valikuline	Päringu teinud isiku sünnikuupäev.
identityCode	string | null	Valikuline	Päringu teinud isiku isikukood või välisriigi isikukood.
identityCodeCountry	string	Kohustuslik	Päringu teinud isiku isikukoodi riik. Välisriigi koodi korral kasutada vastavat riigikoodi.
onlyValid	boolean	Valikuline	Kuvab ainult kehtivad andmed. Vaikimisi: true. Kui väärtus on false, võib vastus sisaldada ka lõppenud või kehtetuid tegeliku kasusaaja kirjeid; sellisel juhul vaata välju startDate, endDate ja terminationType.

Päise parameetrid

Parameeter	Tüüp	Kohustuslik	Kirjeldus
apiVersion	ApiVersions	Valikuline	API versiooni päis Vaikimisi: V1.
acceptLanguage	AcceptLanguage	Valikuline	Klassifikaatorite tõlgete keel (est – eesti, eng – inglise) Vaikimisi: est.

Vastuse skeem

BeneficialOwnersResponse

Väli	Tüüp	Kirjeldus
beneficiariesTotal	integer (int64)	Kohustuslik. Vastuses olevate tegelike kasusaajate arv.
hiddenBeneficiariesNumber	integer (int64)	Kohustuslik. Peidetud tegelike kasusaajate arv.
filedNoBeneficiaryNotice	boolean	Kohustuslik. Näitab, kas on esitatud teade tegelike kasusaajate puudumise kohta.
mustSubmitBeneficialOwners	boolean	Kohustuslik. Näitab, kas juriidiline isik peab esitama tegelike kasusaajate andmed.
beneficiary	array[Beneficiary]	Kohustuslik. Tegelike kasusaajate nimekiri vastuses.

Beneficiary

Väli	Tüüp	Kirjeldus
person	PersonInfo	Kohustuslik. Isiku andmed.
country	string	Kohustuslik. Elukoha riigi kood.
countryAsText	string	Kohustuslik. Elukoha riigi nimetus tekstina.
authorityMethod	string	Kohustuslik. Kontrolli või mõju teostamise viisi kood.
authorityMethodAsText	string	Kohustuslik. Kontrolli või mõju teostamise viisi nimetus.
terminationType	string | null	Lõpetamise liik.
terminationTypeAsText	string | null	Lõpetamise liigi nimetus.
beneficiaryDiscrepancyFiled	boolean	Kohustuslik. Näitab, kas tegeliku kasusaaja kohta on esitatud lahknevusteade.
recordId	integer | null	Kirje ID.
startDate	string (date) | null	Alguskuupäev.
endDate	string (date) | null	Lõppkuupäev.

PersonInfo

Väli	Tüüp	Kirjeldus
type	string	Kohustuslik. Isiku tüüp.
firstName	string | null	Eesnimi.
surnameLegalEntityName	string	Kohustuslik. Perekonnanimi või juriidilise isiku nimi.
identityCode	string | null	Isikukood.
foreignCode	string | null	Välisriigi isikukood.
foreignCodeCountry	string | null	Välisriigi koodi riik.
foreignCodeCountryAsText	string | null	Välisriigi koodi riigi nimetus.
birthday	string (date) | null	Sünniaeg.

JSON Schema

{
 "BeneficialOwnersResponse": {
 "type": "object",
 "required": [
 "beneficiariesTotal",
 "hiddenBeneficiariesNumber",
 "filedNoBeneficiaryNotice",
 "mustSubmitBeneficialOwners",
 "beneficiary"
 ],
 "properties": {
 "beneficiariesTotal": {
 "type": "integer",
 "format": "int64",
 "description": "Vastuses olevate tegelike kasusaajate arv"
 },
 "hiddenBeneficiariesNumber": {
 "type": "integer",
 "format": "int64",
 "description": "Peidetud tegelike kasusaajate arv"
 },
 "filedNoBeneficiaryNotice": {
 "type": "boolean",
 "description": "Kas on esitatud teade tegelike kasusaajate puudumise kohta"
 },
 "mustSubmitBeneficialOwners": {
 "type": "boolean",
 "description": "Kas juriidiline isik peab tegeliku kasusaaja andmed esitama"
 },
 "beneficiary": {
 "type": "array",
 "items": { "$ref": "#/components/schemas/Beneficiary" },
 "description": "Tegelike kasusaajate nimekiri"
 }
 }
 },
 "Beneficiary": {
 "type": "object",
 "required": [
 "person",
 "country",
 "countryAsText",
 "authorityMethod",
 "authorityMethodAsText",
 "beneficiaryDiscrepancyFiled"
 ],
 "properties": {
 "person": { "$ref": "#/components/schemas/PersonInfo" },
 "country": { "type": "string", "description": "Riigi kood" },
 "countryAsText": { "type": "string", "description": "Riigi nimetus tekstina" },
 "authorityMethod": { "type": "string", "description": "Kontrolli või mõju teostamise viisi kood" },
 "authorityMethodAsText": { "type": "string", "description": "Kontrolli või mõju teostamise viisi nimetus" },
 "terminationType": { "type": ["string", "null"], "description": "Lõpetamise liik" },
 "terminationTypeAsText": { "type": ["string", "null"], "description": "Lõpetamise liigi nimetus" },
 "beneficiaryDiscrepancyFiled": { "type": "boolean", "description": "Kas tegeliku kasusaaja kohta on esitatud lahknevusteade" },
 "recordId": { "type": ["integer", "null"], "format": "int64", "description": "Kirje ID" },
 "startDate": { "type": ["string", "null"], "format": "date", "description": "Alguskuupäev" },
 "endDate": { "type": ["string", "null"], "format": "date", "description": "Lõppkuupäev" }
 }
 },
 "PersonInfo": {
 "type": "object",
 "required": ["type", "surnameLegalEntityName"],
 "properties": {
 "type": { "type": "string", "description": "Isiku tüüp" },
 "firstName": { "type": ["string", "null"], "description": "Eesnimi" },
 "surnameLegalEntityName": { "type": "string", "description": "Perekonnanimi või juriidilise isiku nimi" },
 "identityCode": { "type": ["string", "null"], "description": "Isikukood või registrikood" },
 "foreignCode": { "type": ["string", "null"], "description": "Välisriigi isikukood" },
 "foreignCodeCountry": { "type": ["string", "null"], "description": "Välisriigi koodi riik" },
 "foreignCodeCountryAsText": { "type": ["string", "null"], "description": "Välisriigi koodi riigi nimetus" },
 "birthday": { "type": ["string", "null"], "format": "date", "description": "Sünniaeg" }
 }
 }
}

Vastused

200 OK

Edukas päring – tagastab tegelike kasusaajate andmed. Vastus ei ole tühi objekt, vaid sisaldab koondvälju ja massiivi beneficiary.

{
 "beneficiariesTotal": 1,
 "hiddenBeneficiariesNumber": 0,
 "filedNoBeneficiaryNotice": false,
 "mustSubmitBeneficialOwners": true,
 "beneficiary": [
 {
 "person": {
 "type": "P",
 "firstName": "Mari",
 "surnameLegalEntityName": "Maasikas",
 "identityCode": "46205020001",
 "foreignCode": null,
 "foreignCodeCountry": null,
 "foreignCodeCountryAsText": null,
 "birthday": null
 },
 "country": "EST",
 "countryAsText": "Eesti",
 "authorityMethod": "J",
 "authorityMethodAsText": "kõrgema juhtorgani liige",
 "terminationType": null,
 "terminationTypeAsText": null,
 "beneficiaryDiscrepancyFiled": false,
 "recordId": 9000806161,
 "startDate": "2018-10-23",
 "endDate": null
 }
 ]
}

204 No Content

Päring õnnestus, kuid päringule vastavaid andmeid ei ole.

// Response body puudub

404 Not Found

Ettevõtet antud registrikoodiga ei leitud või päringule ei leitud vasteid. Vastus kasutab skeemi CustomValidationError.

{
 "message": "Registry code 100453924 did not return any matches",
 "code": 4043,
 "id": "COMPANY_NOT_FOUND",
 "timestamp": "2026-06-09T12:02:55.733698+03:00"
}

422 Validation Error

Vigane päring – parameetrid ei vasta OpenAPI valideerimisreeglitele. Vastus kasutab skeemi HTTPValidationError.

{
 "detail": [
 {
 "loc": ["path", "registryCode"],
 "msg": "Input should be a valid integer",
 "type": "int_parsing"
 }
 ]
}

Seotud klassifikaatorid

Allolevad klassifikaatorid on seotud tegelike kasusaajate andmetega ja aitavad tõlgendada vastuses olevaid koodivälju.

Kontrolli või mõju teostamise viis

Kood	Nimetus
C	Juhatuse liige või liikmed
F	Muul viisil kontroll või mõju (lepingulised, perekondlikud vm suhted)
J	Kõrgema juhtorgani liige, s.o juhatuse liige või nõukogu liige
K	Kaudne osalus
O	Otsene osalus
S	Soodustatud isik
Z	Asutajaõiguste teostaja, nõukogu liige, juhatuse liige
X	Suurem kui 50%-line osalus konsolideeritava üksuse hääleõiguses
Y	Õigus nimetada või tagasi kutsuda enamikku tegevjuhtkonnast või kõrgema juhtorgani liikmeist

Tegeliku kasusaaja isiku olek

Kood	Nimetus	Märkus
E	Ekslik	Ekslik kirje
K	Kehtetu	Kehtetu kirje
R	Registris	Registris olev kirje
U	Kehtetu, uuem olemas	Kehtetu kirje, mille kohta on olemas uuem kirje