Query of trusts

Query name: arireg.usaldushaldused_v1
Additional information: Valid as of 25.05.2022
Explanation: Query of trusts and persons related to trusts
XSD: https://www2.rik.ee/schemas/xtee6/arireg/test/xroad6_usaldushaldused_v1.xsd

Input parameters / search variables:

Name	Meaning	Notes
ariregister_kasutajanimi	e-Business Register user name	(required)
ariregister_parool	e-Business Register password	(required)
Äriregister_sessioon	e-Business Register session
ariregister_valjundi_formaat	e-Business Register output format (xml or json)
usaldushalduse_nimi	Name of the trust
fyysilise_isiku_eesnimi	First name of the related natural person
fyysilise_isiku_perekonnanimi	Last name of the related natural person
fyysilise_isiku_synniaeg	Date of birth of the related natural person
fyysilise_isiku_kood	ID code of the related natural person
ainult_kehtivad	Whether to display only valid data in the output (true/false)
keel	Classifier translation language (est-estonian, eng-english)
evarv	The maximum number of companies included in the output, the default value is always 10. There can be a maximum of 100 trust managements.
lehekylg	Query response page, 1 by default

Output data:

Name	Meaning	Notes
usaldushalduse_id	ID of the trust
nimi	Name of the trust
registreerimise_kpv	Registration date of the trust
staatus	Status of the trust	R-Registered, K-Deleted
riik	Country code of the trust
riik_tekstina	Country of the trust as text
kasusaajate_arv_kokku	Total number of beneficial owners
peidetud_kasusaajad_arv	Number of hidden beneficial owners
lahknevusteade_puudumisest	Whether an indication of the absence of beneficial owners has been submitted
isikud	Persons related to the trust
roll	Role of the person	UH.HALDUR - Usaldushaldur (Trustee) UH.LOOJA - Usaldushalduse või -ühenduse looja (the settlor of the trust or the establisher of the arrangement) UH.MUUKONTROLL - Muud isikud, kes omavad kontrolli (other person who in any way exercises ultimate control over the property of the trust or arrangement.) UH.VARASAIL - Vara säilimist tagav ja kontrolliv isik ( the person ensuring and controlling the preservation of property, where such person has been appointed) UH.SOODUST - Soodustatud isik ( the beneficiary, or where the beneficiary or beneficiaries are yet to be determined, the class of persons in whose main interest such triste or arrangement has been set up or operates)
eesnimi	First name
nimi	Family name
isikukood	ID code
valis_kood	Foreign ID code
valis_kood_riik	Country of Foreign ID code
valis_kood_riik_tekstina	Country of foreign ID code as text
synniaeg	Date of birth
aadress_riik	Country of the address
aadress_riik_tesktina	Country of the address as text
elukoht_riik	Country of residence	Issued only for the trustee role
elukoht_riik_tekstina	Country of residence as text	Issued only for the trustee role
algus_kpv	Start date
lopp_kpv	Ending date
lahknevusteade_esitatud	Presence of discrepancy notice	Has a notice of discrepancy been submitted to this person

Sample request:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:prod="http://arireg.x-road.eu/producer/">
 <soapenv:Header/>
 <soapenv:Body>
 <prod:usaldushaldused_v1>
 <prod:keha>
 <prod:ariregister_kasutajanimi>kasutajanimi</prod:ariregister_kasutajanimi>
 <prod:ariregister_parool>parool</prod:ariregister_parool>
 <prod:ariregister_sessioon></prod:ariregister_sessioon>
 <prod:ariregister_valjundi_formaat>xml</prod:ariregister_valjundi_formaat>
 <prod:usaldushalduse_nimi>trust english</prod:usaldushalduse_nimi>
 <prod:fyysilise_isiku_eesnimi></prod:fyysilise_isiku_eesnimi>
 <prod:fyysilise_isiku_perekonnanimi></prod:fyysilise_isiku_perekonnanimi>
 <prod:fyysilise_isiku_synniaeg></prod:fyysilise_isiku_synniaeg>
 <prod:fyysilise_isiku_kood></prod:fyysilise_isiku_kood>
 <prod:ainult_kehtivad>0</prod:ainult_kehtivad>
 <prod:keel>est</prod:keel>
 <prod:evarv></prod:evarv>
 <prod:lehekylg></prod:lehekylg>
 </prod:keha>
 </prod:usaldushaldused_v1>
 </soapenv:Body>
</soapenv:Envelope>

Sample response:

<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:usaldushaldused_v1Response>
 <ns1:paring>
 <ns1:ariregister_kasutajanimi>kasutajanimi</ns1:ariregister_kasutajanimi>
 <ns1:ariregister_parool>parool</ns1:ariregister_parool>
 <ns1:ariregister_sessioon/>
 <ns1:ariregister_valjundi_formaat>xml</ns1:ariregister_valjundi_formaat> <ns1:usaldushalduse_nimi>trust english</ns1:usaldushalduse_nimi>
 <ns1:fyysilise_isiku_eesnimi/>
 <ns1:fyysilise_isiku_perekonnanimi/>
 <ns1:fyysilise_isiku_kood/>
 <ns1:ainult_kehtivad>false</ns1:ainult_kehtivad>
 <ns1:keel>est</ns1:keel>
 </ns1:paring>
 <ns1:keha>
 <ns1:usaldushaldused>
 <ns1:item>
 <ns1:usaldushalduse_id>32</ns1:usaldushalduse_id>
 <ns1:nimi>trust english</ns1:nimi>
 <ns1:registreerimise_kpv>2022-05-01Z</ns1:registreerimise_kpv>
 <ns1:staatus>R</ns1:staatus>
 <ns1:riik>ASM</ns1:riik>
 <ns1:riik_tekstina>Ameerika Samoa</ns1:riik_tekstina>
 <ns1:kasusaajate_arv_kokku>6</ns1:kasusaajate_arv_kokku>
 <ns1:peidetud_kasusaajate_arv>0</ns1:peidetud_kasusaajate_arv>
 <ns1:lahknevusteade_puudumisest>true</ns1:lahknevusteade_puudumisest>
 <ns1:isikud>
 <ns1:isik>
 <ns1:roll>UH.LOOJA</ns1:roll>
 <ns1:nimi>Test OÜ</ns1:nimi>
 <ns1:isikukood>1111111</ns1:isikukood>
 <ns1:elukoht_riik>EST</ns1:elukoht_riik>
 <ns1:elukoht_riik_tekstina>Eesti</ns1:elukoht_riik_tekstina>
 <ns1:algus_kpv>2022-05-03Z</ns1:algus_kpv>
 <ns1:lopp_kpv>2022-05-06Z</ns1:lopp_kpv>
 <ns1:lahknevusteade_esitatud>false</ns1:lahknevusteade_esitatud>
 </ns1:isik>
 <ns1:isik>
 <ns1:roll>UH.HALDUR</ns1:roll>
 <ns1:eesnimi>Edith</ns1:eesnimi>
 <ns1:nimi>Rik</ns1:nimi>
 <ns1:isikukood>49999999999</ns1:isikukood>
 <ns1:aadress_riik>EST</ns1:aadress_riik>
 <ns1:aadress_riik_tekstina>Eesti</ns1:aadress_riik_tekstina>
 <ns1:algus_kpv>2022-05-03Z</ns1:algus_kpv>
 <ns1:lahknevusteade_esitatud>false</ns1:lahknevusteade_esitatud>
 </ns1:isik>
 <ns1:isik>
 <ns1:roll>UH.SOODUST</ns1:roll>
 <ns1:eesnimi>Edith</ns1:eesnimi>
 <ns1:nimi>Rik</ns1:nimi>
 <ns1:isikukood>49999999999</ns1:isikukood>
 <ns1:elukoht_riik>EST</ns1:elukoht_riik>
 <ns1:elukoht_riik_tekstina>Eesti</ns1:elukoht_riik_tekstina>
 <ns1:algus_kpv>2022-05-06Z</ns1:algus_kpv>
 <ns1:lahknevusteade_esitatud>false</ns1:lahknevusteade_esitatud>
 </ns1:isik>
 <ns1:isik>
 <ns1:roll>UH.LOOJA</ns1:roll>
 <ns1:nimi>Ettevõte OÜ</ns1:nimi>
 <ns1:isikukood>222222222</ns1:isikukood>
 <ns1:elukoht_riik>EST</ns1:elukoht_riik>
 <ns1:elukoht_riik_tekstina>Eesti</ns1:elukoht_riik_tekstina>
 <ns1:algus_kpv>2022-05-06Z</ns1:algus_kpv>
 <ns1:lahknevusteade_esitatud>false</ns1:lahknevusteade_esitatud>
 </ns1:isik>
 </ns1:isikud>
 </ns1:item>
 </ns1:usaldushaldused>
 <ns1:leitud_arv>1</ns1:leitud_arv>
 </ns1:keha>
 </ns1:usaldushaldused_v1Response>
 </SOAP-ENV:Body>
</SOAP-ENV:Envelope>