Meetod: GET /company/{registryCode}/relatedPersons

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

Tagastab ettevõttega seotud isikute andmed – juhatuse liikmed, osanikud, aktsionärid, prokuristid, nõukogu liikmed ja muud seotud isikud. Sisaldab esindusõiguse infot, kaardile kantud isikuid, osalusandmeid.

Tee parameetrid

Parameeter	Tüüp	Kohustuslik	Kirjeldus
registryCode	integer	Kohustuslik	Ettevõtte registrikood.

Päringu parameetrid

Parameeter	Tüüp	Kohustuslik	Kirjeldus
onlyValid	boolean	Valikuline	Kuvab ainult kehtivad andmed. Vaikeväärtus: true.

Päise parameetrid

Parameeter	Tüüp	Kohustuslik	Kirjeldus
apiVersion	ApiVersions	Valikuline	API versiooni päis Vaikeväärtus: "V1"; Lubatud väärtused: ["V1"]; Toetatud versioonid: ["V1"].
acceptLanguage	AcceptLanguage	Valikuline	Klassifikaatorite tõlgete keel (est – eesti, eng – inglise) Vaikeväärtus: "est"; Lubatud väärtused: ["est", "eng"].

Vastuse skeem

CompanyRelatedPersonsResponse

Väli	Tüüp	Kirjeldus
legalEntityName	string	Kohustuslik. Ettevõtte ärinimi
registryCode	integer	Kohustuslik. Ettevõtte registrikood
companyId	integer	Kohustuslik. Ettevõtte sisemine ID
vatID	string | null	Käibemaksukohustuslase number
relatedPersons	DetailDataRelatedPersons | null	Seotud isikud

DetailDataRelatedPersons

Väli	Tüüp	Kirjeldus
representationRights	RepresentationRights	Kohustuslik. Esindusõigused
personsOnCard	array[PersonsOnCard] | null	Kohustuslik. Kaardile kantud isikud
representationRightNormalRulings	array[RepresentationRightNormalRuling] | null	Esindusõiguse tavareegel
representationRightSpecialConditions	array[RecordType] | null	Esindusõiguse eritingimused
partialPledgesAndTransfers	array[DetailDataPartialPledge] | null	Osalised pandid ja tingimuslikud võõrandamised
shareholders	array[NonCardRelatedPerson] | null	Osanikud ja aktsionärid
nonCardRelatedPersons	array[NonCardRelatedPerson] | null	Kaardile kandmata seotud isikud
buildingAssociationMembers	array[BuildingAssociationMember] | null	Hooneühistu liikmed

RepresentationRights

Väli	Tüüp	Kirjeldus
persons	array[RepresentationRightsPerson]	Kohustuslik. Isikud
representationRightSpecialConditions	array[string]	Kohustuslik. Esindusõiguse eritingimused
representationRightGroups	array[RepresentationRightsGroup]	Kohustuslik. Ühise esindusõiguse rühmad. Iga rühm näitab isikuid, kellel on ühiselt õigus ettevõtet esindada; oluline eelkõige ainuesindusõiguse puudumisel.

RepresentationRightsPerson

Väli	Tüüp	Kirjeldus
firstName	string | null	Eesnimi
surnameLegalEntityName	string	Kohustuslik. Perekonnanimi või ärinimi
entityCode	string | null	Isikukood või registrikood
entityCodeCountry	string	Kohustuslik. Isiku- või registrikoodi riik (ISO 3166-1 alpha-3)
entityCodeCountryAsText	string | null	Isiku- või registrikoodi riik tekstina
birthday	string (date) | null	Sünnikuupäev
personType	string	Kohustuslik. Isiku tüüp
role	string	Kohustuslik. Isiku roll
roleAsText	string	Kohustuslik. Roll tekstina
exclusiveRightOfRepresentation	boolean | null	Ainuesindusõiguse olemasolu

RepresentationRightsGroup

Väli	Tüüp	Kirjeldus
groupNumber	integer	Kohustuslik. Rühma number
persons	array[RepresentationRightsPerson]	Kohustuslik. Rühma isikud

PersonsOnCard

Väli	Tüüp	Kirjeldus
person	PersonRolesInfo	Kohustuslik. Isiku rollide andmed
address	FullAddress	Kohustuslik. Täisaadress
is_gov_institution	boolean | null	Kas on riigiasutus
company_registry_status	string | null	Juriidilise isiku registristaatus
has_active_tradebans	boolean | null	Kas isikul on kehtivaid ärikeelde
expirationDate	string (date) | null	Kehtivuse lõppkuupäev
email	string | null	E-posti aadress
cardNumber	integer (int64) | null	Kaardi number
cardType	string | null	Kaardi tüüp
entryNumber	integer (int64) | null	Kande number
recordId	integer (int64) | null	ID
startDate	string (date) | null	Alguskuupäev
endDate	string (date) | null	Lõppkuupäev

PersonRolesInfo

Väli	Tüüp	Kirjeldus
role	string	Kohustuslik. Isiku roll
roleAsText	string	Kohustuslik. Isiku roll tekstina
startDate	string (date) | null	Seose alguskuupäev
endDate	string (date) | null	Seose lõppkuupäev
type	string	Kohustuslik. Isiku tüüp
firstName	string | null	Eesnimi
surnameLegalEntityName	string	Kohustuslik. Perekonnanimi või ärinimi
identityCode	string | null	Kohustuslik. Isiku- või registrikood
foreignCode	string | null	Välisriigi isikukood
foreignCodeCountry	string | null	Välisriigi isikukoodi riik
foreignCodeCountryAsText	string | null	Välisriigi isikukoodi riik tekstina
birthday	string (date) | null	Sünnikuupäev
share	ShareData | null	Osalusandmed (rollid O, OSAN, S)

FullAddress

Väli	Tüüp	Kirjeldus
country	string | null	Riik
countryAsText	string | null	Riik tekstina
address	string | null	Aadress
postalCode	string | null	Postiindeks
ehak	string | null	EHAK kood Minimaalne pikkus: 1.
ehakAsText	string | null	EHAK tekstina Minimaalne pikkus: 1.
adsAdobId	string | null	Aadressi ADOBID
adsNormalizedFullAddressSuffix	string | null	Normaliseeritud ADS-aadressi tekstiline täiendus (nt postkasti number)
adsType	string | null	Aadressi tüüp: 0 – täielik ADS, 1 – osaline ADS, 2 – ADS-ita
adsOid	string | null	Aadressi ADS OID
adrId	integer | null	Aadressi ADR ID
adsNormalizedFullAddress	string | null	ADS-i normaliseeritud täisaadress
adsCodeAddress	string | null	Aadressi ADS-kood
loadingDate	string (date) | null	Andmete KR-ist laadimise kuupäev

RepresentationRightNormalRuling

Väli	Tüüp	Kirjeldus
role	string	Kohustuslik. Isiku roll
content	string	Kohustuslik. Sisu

RecordType

Väli	Tüüp	Kirjeldus
type	string | null	Tüüp
typeAsText	string | null	Tüüp tekstina
content	string | null	Sisu
cardNumber	integer (int64) | null	Kaardi number
cardType	string | null	Kaardi tüüp
entryNumber	integer (int64) | null	Kande number
recordId	integer (int64) | null	ID
startDate	string (date) | null	Alguskuupäev
endDate	string (date) | null	Lõppkuupäev

DetailDataPartialPledge

Väli	Tüüp	Kirjeldus
partialPledgesORTransfers	string	Kohustuslik. Osaline pant või tingimuslik võõrandamine
owner	PersonTypeInfo	Kohustuslik. Omaniku andmed
size	number (double) | null	Osa suurus
rank	integer (int64) | null	Osalise pandi järjekoht
description	string | null	Osalise pandi kirjeldus
recordId	integer (int64) | null	ID
startDate	string (date) | null	Alguskuupäev
endDate	string (date) | null	Lõppkuupäev

PersonTypeInfo

Väli	Tüüp	Kirjeldus
type	string	Kohustuslik. Isiku tüüp
firstName	string | null	Eesnimi
surnameLegalEntityName	string	Kohustuslik. Perekonnanimi või ärinimi
identityCode	string | null	Isiku- või registrikood
foreignCode	string | null	Välisriigi isikukood
foreignCodeCountry	string | null	Välisriigi isikukoodi riik
foreignCodeCountryAsText	string | null	Välisriigi isikukoodi riik tekstina
birthday	string (date) | null	Sünnikuupäev

NonCardRelatedPerson

Väli	Tüüp	Kirjeldus
person	PersonRolesInfo	Kohustuslik. Isiku rollide andmed
email	string | null	E-posti aadress
address	FullAddress	Kohustuslik. Täisaadress
is_gov_institution	boolean | null	Kas on riigiasutus
company_registry_status	string | null	Juriidilise isiku registristaatus
has_active_tradebans	boolean | null	Kas isikul on kehtivaid ärikeelde
sharePercentage	number (double) | null	Osaluse protsent
shareSize	number (double) | null	Osaluse suurus
shareCurrency	string | null	Osaluse valuuta
shareCurrencyAsText	string | null	Osaluse valuuta tekstina
shareOwnershipType	string | null	Omandi liik
shareOwnershipTypeAsText	string | null	Omandi liik tekstina
shareFractionNumerator	integer (int64) | null	Murru lugeja
shareFractionDenominator	integer (int64) | null	Murru nimetaja
expirationDate	string (date) | null	Kehtivuse lõppkuupäev
authoritySource	string | null	Volituse alus
authoritySourceAsText	string | null	Volituse alus tekstina
authoritySourceDate	string (date) | null	Volituse aluse kuupäev
groupId	integer (int64) | null	Rühma ID
recordId	integer (int64) | null	ID
startDate	string (date) | null	Alguskuupäev
endDate	string (date) | null	Lõppkuupäev

BuildingAssociationMember

Väli	Tüüp	Kirjeldus
membershipNumber	string	Kohustuslik. Liikmenumber
area	number (float) | null	Pindala
taxRateNumerator	integer (int64) | null	Maksumäära lugeja
taxRateDenominator	integer (int64) | null	Maksumäära nimetaja
members	array[BuildingAssociationParticipant]	Kohustuslik. Hooneühistu liikmed
restrictions	array[BuildingAssociationRestriction]	Kohustuslik. Hooneühistu piirangud
recordId	integer (int64) | null	ID
startDate	string (date) | null	Alguskuupäev
endDate	string (date) | null	Lõppkuupäev

BuildingAssociationParticipant

Väli	Tüüp	Kirjeldus
person	PersonTypeInfo	Kohustuslik. Isiku andmed
contribution	number (float) | null	Osamakse
email	string | null	E-posti aadress
address	FullAddress	Kohustuslik. Täisaadress
ownershipType	string	Kohustuslik. Omandi liik
ownershipTypeAsText	string | null	Omandi liik tekstina
fractionNumerator	integer (int64) | null	Murru lugeja
fractionDenominator	integer (int64) | null	Murru nimetaja
groupId	integer (int64) | null	Rühma ID
recordId	integer (int64) | null	ID
startDate	string (date) | null	Alguskuupäev
endDate	string (date) | null	Lõppkuupäev

BuildingAssociationRestriction

Väli	Tüüp	Kirjeldus
type	string	Kohustuslik. Tüüp
typeAsText	string	Kohustuslik. Tüüp tekstina
content	string	Kohustuslik. Sisu
recordId	integer (int64) | null	ID
startDate	string (date) | null	Alguskuupäev
endDate	string (date) | null	Lõppkuupäev

CustomValidationError

Väli	Tüüp	Kirjeldus
message	string	Kohustuslik. Veateade
code	APIError	Kohustuslik. Veakood. Lubatud väärtused: 2001, 4030, 4041, 4042, 4043, 4044, 4045, 4046, 4047, 4048, 4049.
id	string | null	Kohustuslik. Vea identifikaator
timestamp	string (date-time)	Vea ajatempel

HTTPValidationError

Väli	Tüüp	Kirjeldus
detail	array[ValidationError]	Valideerimisvigade loend

ShareData

Väli	Tüüp	Kirjeldus
sharePercentage	number (double) | null	Osaluse protsent
shareSize	number (double) | null	Osaluse suurus
shareCurrencyAsText	string | null	Osaluse valuuta tekstina

ValidationError

Väli	Tüüp	Kirjeldus
loc	array[string | integer]	Kohustuslik. Vea asukoht päringus
msg	string	Kohustuslik. Veateade
type	string	Kohustuslik. Vea tüüp
input	any	Valideerimisvea põhjustanud sisend. Tüüp ei ole piiratud.
ctx	object	Vea lisakontekst

Vastused

Edukas päring – juhatuse liige esindusõiguse tavareegliga ja ainuosanik. Esindusõigust tuleb hinnata tagastatud õiguste ja tingimuste, mitte üksnes rollikoodi järgi.

{
 "legalEntityName": "NÄIDIS OÜ",
 "registryCode": 12345678,
 "companyId": 987654,
 "vatID": "EE101234567",
 "relatedPersons": {
 "representationRights": {
 "persons": [
 {
 "firstName": "Mari",
 "surnameLegalEntityName": "Maasikas",
 "entityCode": "48503151233",
 "entityCodeCountry": "EST",
 "birthday": "1985-03-15",
 "personType": "F",
 "role": "JUHL",
 "roleAsText": "Juhatuse liige",
 "exclusiveRightOfRepresentation": true,
 "entityCodeCountryAsText": "Eesti"
 }
 ],
 "representationRightSpecialConditions": [],
 "representationRightGroups": []
 },
 "personsOnCard": [
 {
 "person": {
 "role": "JUHL",
 "roleAsText": "Juhatuse liige",
 "startDate": "2024-05-15",
 "endDate": null,
 "type": "F",
 "firstName": "Mari",
 "surnameLegalEntityName": "Maasikas",
 "identityCode": "48503151233",
 "foreignCode": null,
 "foreignCodeCountry": null,
 "foreignCodeCountryAsText": null,
 "birthday": "1985-03-15"
 },
 "address": {},
 "expirationDate": null,
 "email": "[email protected]",
 "cardNumber": 1,
 "cardType": "R",
 "entryNumber": 1,
 "recordId": 111222,
 "startDate": "2024-05-15",
 "endDate": null
 }
 ],
 "representationRightNormalRulings": [
 {
 "role": "JUHL",
 "content": "Osaühingut võib kõikide tehingute tegemisel esindada iga juhatuse liige."
 }
 ],
 "representationRightSpecialConditions": null,
 "partialPledgesAndTransfers": null,
 "shareholders": [
 {
 "person": {
 "role": "OSAN",
 "roleAsText": "Osanik",
 "startDate": "2024-05-15",
 "endDate": null,
 "type": "F",
 "firstName": "Mari",
 "surnameLegalEntityName": "Maasikas",
 "identityCode": "48503151233",
 "foreignCode": null,
 "foreignCodeCountry": null,
 "foreignCodeCountryAsText": null,
 "birthday": "1985-03-15",
 "share": {
 "sharePercentage": 100.0,
 "shareSize": 2500.0,
 "shareCurrencyAsText": "euro"
 }
 },
 "address": {},
 "sharePercentage": 100.0,
 "shareSize": 2500.0,
 "shareCurrency": "EUR",
 "shareCurrencyAsText": "euro",
 "shareOwnershipType": "L",
 "shareOwnershipTypeAsText": "Ainuomand",
 "shareFractionNumerator": null,
 "shareFractionDenominator": null,
 "expirationDate": null,
 "authoritySource": null,
 "authoritySourceAsText": null,
 "authoritySourceDate": null,
 "groupId": null,
 "recordId": 111333,
 "startDate": "2024-05-15",
 "endDate": null
 }
 ],
 "nonCardRelatedPersons": null,
 "buildingAssociationMembers": null
 }
}

Edukas päring – esindusõiguse normaalregulatsiooni erisus koos välisriigi juhatuse liikme ja nõukogu liikmega.

{
 "legalEntityName": "SUUR ETTEVÕTE AS",
 "registryCode": 10000001,
 "companyId": 123456,
 "vatID": "EE100000001",
 "relatedPersons": {
 "representationRights": {
 "persons": [
 {
 "firstName": "Jüri",
 "surnameLegalEntityName": "Juurikas",
 "entityCode": "38006201232",
 "entityCodeCountry": "EST",
 "birthday": "1980-06-20",
 "personType": "F",
 "role": "JUHL",
 "roleAsText": "Juhatuse liige",
 "exclusiveRightOfRepresentation": true,
 "entityCodeCountryAsText": "Eesti"
 },
 {
 "firstName": "Anna",
 "surnameLegalEntityName": "Aedmaasikas",
 "entityCode": "49011251238",
 "entityCodeCountry": "EST",
 "birthday": "1990-11-25",
 "personType": "F",
 "role": "JUHL",
 "roleAsText": "Juhatuse liige",
 "exclusiveRightOfRepresentation": false,
 "entityCodeCountryAsText": "Eesti"
 },
 {
 "firstName": "Erik",
 "surnameLegalEntityName": "Esimerkki",
 "entityCode": "FI-EXAMPLE-001",
 "entityCodeCountry": "FIN",
 "birthday": "1988-08-12",
 "personType": "F",
 "role": "JUHL",
 "roleAsText": "Juhatuse liige",
 "exclusiveRightOfRepresentation": false,
 "entityCodeCountryAsText": "Soome"
 }
 ],
 "representationRightSpecialConditions": [
 "Äriühingut võib esindada Jüri Juurikas üksinda või Anna Aedmaasikas ja Erik Esimerkki ühiselt."
 ],
 "representationRightGroups": [
 {
 "groupNumber": 1,
 "persons": [
 {
 "firstName": "Anna",
 "surnameLegalEntityName": "Aedmaasikas",
 "entityCode": "49011251238",
 "entityCodeCountry": "EST",
 "birthday": "1990-11-25",
 "personType": "F",
 "role": "JUHL",
 "roleAsText": "Juhatuse liige",
 "exclusiveRightOfRepresentation": false,
 "entityCodeCountryAsText": "Eesti"
 },
 {
 "firstName": "Erik",
 "surnameLegalEntityName": "Esimerkki",
 "entityCode": "FI-EXAMPLE-001",
 "entityCodeCountry": "FIN",
 "birthday": "1988-08-12",
 "personType": "F",
 "role": "JUHL",
 "roleAsText": "Juhatuse liige",
 "exclusiveRightOfRepresentation": false,
 "entityCodeCountryAsText": "Soome"
 }
 ]
 }
 ]
 },
 "personsOnCard": [
 {
 "person": {
 "role": "JUHL",
 "roleAsText": "Juhatuse liige",
 "startDate": "2024-05-15",
 "endDate": null,
 "type": "F",
 "firstName": "Jüri",
 "surnameLegalEntityName": "Juurikas",
 "identityCode": "38006201232",
 "foreignCode": null,
 "foreignCodeCountry": null,
 "foreignCodeCountryAsText": null,
 "birthday": "1980-06-20"
 },
 "address": {},
 "expirationDate": null,
 "email": null,
 "cardNumber": 1,
 "cardType": "R",
 "entryNumber": 3,
 "recordId": 222111,
 "startDate": "2024-05-15",
 "endDate": null
 },
 {
 "person": {
 "role": "JUHL",
 "roleAsText": "Juhatuse liige",
 "startDate": "2024-05-15",
 "endDate": null,
 "type": "F",
 "firstName": "Anna",
 "surnameLegalEntityName": "Aedmaasikas",
 "identityCode": "49011251238",
 "foreignCode": null,
 "foreignCodeCountry": null,
 "foreignCodeCountryAsText": null,
 "birthday": "1990-11-25"
 },
 "address": {},
 "expirationDate": null,
 "email": null,
 "cardNumber": 1,
 "cardType": "R",
 "entryNumber": 3,
 "recordId": 222114,
 "startDate": "2024-05-15",
 "endDate": null
 },
 {
 "person": {
 "role": "JUHL",
 "roleAsText": "Juhatuse liige",
 "startDate": "2024-05-15",
 "endDate": null,
 "type": "F",
 "firstName": "Erik",
 "surnameLegalEntityName": "Esimerkki",
 "identityCode": null,
 "foreignCode": "FI-EXAMPLE-001",
 "foreignCodeCountry": "FIN",
 "foreignCodeCountryAsText": "Soome",
 "birthday": "1988-08-12"
 },
 "address": {},
 "expirationDate": null,
 "email": null,
 "cardNumber": 1,
 "cardType": "R",
 "entryNumber": 3,
 "recordId": 222115,
 "startDate": "2024-05-15",
 "endDate": null
 }
 ],
 "shareholders": null,
 "nonCardRelatedPersons": [
 {
 "person": {
 "role": "N",
 "roleAsText": "Nõukogu liige",
 "startDate": "2024-05-15",
 "endDate": null,
 "type": "F",
 "firstName": "Peeter",
 "surnameLegalEntityName": "Porgand",
 "identityCode": "37502071230",
 "foreignCode": null,
 "foreignCodeCountry": null,
 "foreignCodeCountryAsText": null,
 "birthday": "1975-02-07"
 },
 "address": {},
 "expirationDate": null,
 "email": null,
 "recordId": 222112,
 "startDate": "2024-05-15",
 "endDate": null
 }
 ],
 "representationRightSpecialConditions": [
 {
 "content": "Äriühingut võib esindada Jüri Juurikas üksinda või Anna Aedmaasikas ja Erik Esimerkki ühiselt.",
 "cardType": "R",
 "cardNumber": 1,
 "entryNumber": 3,
 "startDate": "2024-05-15",
 "endDate": null,
 "type": "YHESJ",
 "typeAsText": "Juhatuse liikmete või seda asendava organi ühise esindusõiguse tingimused",
 "recordId": 222116
 }
 ],
 "representationRightNormalRulings": [
 {
 "role": "JUHL",
 "content": "Aktsiaseltsi võib kõikide tehingute tegemisel esindada iga juhatuse liige."
 }
 ]
 }
}

Juurdepääs teenusele keelatud. OpenAPI ei määra vastuse keha skeemi.

Illustratiivne veavastus. Kood 4041 on APIError loendis lubatud, kuid OpenAPI ei kirjelda selle tähendust.

{
 "message": "Company not found",
 "code": 4041,
 "id": "abc123-def456"
}

Vigane päring – registrikood ei vasta nõuetele.

{
 "detail": [
 {
 "loc": [
 "path",
 "registryCode"
 ],
 "msg": "value is not a valid integer",
 "type": "type_error.integer"
 }
 ]
}