Method: GET /company/companyRelations
OpenAPI/Swagger: https://ar-rest.rik.ee/docs#/Company/get_company_relations
Searches companies and their relations with natural and legal persons. Filter companies by name, registry code, activity, address and status. Search related natural persons by name, date of birth or ID code, and related legal persons by name or registry code. personRoles filters by the related person’s roles. The response contains company particulars, contact details and persons related to the search.
Query parameters
| Parameter |
Type |
Required |
Description |
|---|
| legalEntityName |
string |
Optional |
Name of the company |
| registryCode |
integer |
Optional |
Registry code of the company |
| activityCode |
string |
Optional |
Activity code of the company |
| personFirstName |
string |
Optional |
First name of the related natural person |
| personSurname |
string |
Optional |
Family name of the related natural person |
| personBirthday |
string (date) |
Optional |
Date of birth of the related natural person |
| identityCode |
string |
Optional |
ID code of the related natural person |
| identityCodeCountry |
string |
Optional |
ID code country of the related natural person |
| personRoles |
array[string] |
Optional |
Filter by related person role codes. See Related person roles. |
| legalPersonName |
string |
Optional |
Name of the related legal person |
| legalPersonCode |
string |
Optional |
Registry code of the related legal person |
| legalPersonCodeCountry |
string |
Optional |
Registry code country of the related legal person |
| locationEnterpriserByAddress |
string |
Optional |
Location at the address of the company |
| adminUnitEnterpriserByAddress |
string |
Optional |
Administrative unit at the address of the entrepreneur |
| onlyValid |
boolean |
Optional |
Display only valid data. Default: true. |
| statuses |
array[CompanyStatus | string] |
Optional |
Company status filter; see Statuses. If omitted, all statuses are returned except project, not-entered and denied. |
| pageNumber |
integer |
Optional |
Results Page Number. Default: 1; Maximum: 100000; Greater than: 0. |
| pageSize |
integer |
Optional |
How many results on one page are desired. Default: 100; Maximum: 1000; Greater than: 0. |
Header parameters
| Parameter |
Type |
Required |
Description |
|---|
| apiVersion |
ApiVersions |
Optional |
API version. Allowed and supported value: V1. Default: V1. |
| acceptLanguage |
AcceptLanguage |
Optional |
Classifier translation language: est – Estonian, eng – English. Default: est. |
Response schema
Required fields must be present. Other fields may be omitted; null is allowed only where shown in the field type.
CompanyRelationsResponse
| Field |
Type |
Description |
|---|
| total |
integer (int64) |
Required. The total number of entities. |
| list |
array[CompanyRequisites] |
Required. Entrepreneurs |
CompanyRequisites
| Field |
Type |
Description |
|---|
| legalEntityName |
string |
Required. Company Business Name/Name Minimum length: 1. |
| registryCode |
integer | null (int64) |
Company registration code |
| legalForm |
string | null |
Legal form of the company. OpenAPI specifies a string without an enumeration of values. |
| legalFormSubtype |
string | null |
Subtype of legal form of entrepreneur |
| status |
string |
Required. Entrepreneur status Minimum length: 1.. See Statuses. |
| statusAsText |
string |
Required. Entrepreneur status as text Minimum length: 1.. See Statuses. |
| firstEntrydate |
string (date) | null |
Date of first entry of entrepreneur |
| deletionDate |
string (date) | null |
Date of entrepreneur deletion for deleted companies |
| einvoiceProvider |
string | null |
Identification of the e-invoice service provider. |
| reportedActivities |
array[ReportedActivityArea] | null |
Reported activities |
| email |
array[RecordType] | null |
E-mail address |
| phone |
array[string] | null |
Phone |
| homepage |
array[string] | null |
The main website of the company |
| infoSystemUrl |
string | null |
Link to the company in the e-business register |
| vatNumber |
string | null |
VAT register number |
| address |
array[RecordFullAddress] | null |
Address |
| searchRelatedPersons |
array[PersonRolesInfo] | null |
Related person for search purposes |
ReportedActivityArea
| Field |
Type |
Description |
|---|
| emtakCode |
string | null |
Code according to the Classification of Economic Activities (EMTAK) |
| emtakAsText |
string | null |
EMTAK code as text |
| emtakVersion |
integer | null (int64) |
EMTAK Version |
| emtakVersionAsText |
string | null |
EMTAK version as text |
| naceCode |
string | null |
NACE code |
| isMainBusinessArea |
boolean | null |
Is main business area |
| recordId |
integer | null (int64) |
ID |
| startDate |
string (date) | null |
Start date |
| endDate |
string (date) | null |
Ending date |
RecordType
| Field |
Type |
Description |
|---|
| type |
string | null |
Type |
| typeAsText |
string | null |
Type as text |
| content |
string | null |
Content |
| cardNumber |
integer | null (int64) |
Card number |
| cardType |
string | null |
Card type |
| entryNumber |
integer | null (int64) |
Entry number |
| recordId |
integer | null (int64) |
ID |
| startDate |
string (date) | null |
Start date |
| endDate |
string (date) | null |
Ending date |
RecordFullAddress
| Field |
Type |
Description |
|---|
| address |
FullAddress |
Required. Full address |
| cardNumber |
integer (int64) |
Required. Card number |
| cardType |
string |
Required. Card type |
| entryNumber |
integer (int64) |
Required. Entry number |
| recordId |
integer (int64) |
Required. ID |
| startDate |
string (date) |
Required. Start date |
| endDate |
string (date) | null |
Ending date |
FullAddress
| Field |
Type |
Description |
|---|
| country |
string | null |
Country |
| countryAsText |
string | null |
Country as text |
| address |
string | null |
Address |
| postalCode |
string | null |
Zip code |
| ehak |
string | null |
EHAK code Minimum length: 1. |
| ehakAsText |
string | null |
EHAK as text Minimum length: 1. |
| adsAdobId |
string | null |
Address: ADOBID |
| adsNormalizedFullAddressSuffix |
string | null |
Normalized ADS address text suffix (e.g. mailbox number) |
| adsType |
string | null |
Address type: 0 - fullADS, 1 - semiADS, 2 - noADS |
| adsOid |
string | null |
Address: ADS OID |
| adrId |
integer | null |
Address: ADR ID |
| adsNormalizedFullAddress |
string | null |
Address: ADS normalized full address |
| adsCodeAddress |
string | null |
Address: ADS code address |
| loadingDate |
string (date) | null |
Date of loading data from KR |
PersonRolesInfo
| Field |
Type |
Description |
|---|
| role |
string |
Required. Person Role. See Related person roles. |
| roleAsText |
string |
Required. Person role as text. See Related person roles. |
| startDate |
string (date) | null |
Connection start date |
| endDate |
string (date) | null |
Connection end date |
| type |
string |
Required. Person kind: F – natural person, J – legal person. |
| firstName |
string | null |
First name |
| surnameLegalEntityName |
string |
Required. Family name or business name |
| identityCode |
string | null |
Required. ID code or registry code |
| foreignCode |
string | null |
Foreign ID code |
| foreignCodeCountry |
string | null |
Country of Foreign ID code |
| foreignCodeCountryAsText |
string | null |
Country of foreign ID code as text |
| birthday |
string (date) | null |
Date of birth |
| share |
ShareData | null |
Share ownership data (O, OSAN, S) |
ShareData
| Field |
Type |
Description |
|---|
| sharePercentage |
number | null (double) |
Share Percentage |
| shareSize |
number | null (double) |
Share Size |
| shareCurrencyAsText |
string | null |
Share Currency as text |
CustomValidationError
| Field |
Type |
Description |
|---|
| message |
string |
Required. Error message. |
| code |
APIError |
Required. Error code. Allowed values are listed in APIError. |
| id |
string | null |
Required. Error identifier. |
| timestamp |
string (date-time) |
Timestamp of the error |
HTTPValidationError
| Field |
Type |
Description |
|---|
| detail |
array[ValidationError] |
Validation errors. |
ValidationError
| Field |
Type |
Description |
|---|
| loc |
array[string | integer] |
Required. Location of the invalid value. |
| msg |
string |
Required. Error message. |
| type |
string |
Required. Error type. |
| input |
any |
Validated input value. |
| ctx |
object |
Additional validation error context. |
Response codes
- 200 – Successful response.
- 204 – No data for the request. No response body.
- 403 – Service access denied. OpenAPI does not specify a response body.
- 404 – Not found (CustomValidationError).
- 422 – Request validation error (HTTPValidationError).
Examples
200 – Company relation to a management board member
GET /company/companyRelations?personFirstName=Mari&personSurname=Maasikas&personRoles=JUHL&statuses=R&pageNumber=1&pageSize=100
acceptLanguage: eng
{
"total": 1,
"list": [
{
"legalEntityName": "Pilveaia OÜ",
"registryCode": 12345678,
"legalForm": null,
"legalFormSubtype": null,
"status": "R",
"statusAsText": "Entered into the register",
"firstEntrydate": "2024-05-15",
"deletionDate": null,
"email": [
{
"type": "EMAIL",
"typeAsText": "E-mail address",
"content": "[email protected]",
"cardNumber": 1,
"cardType": "R",
"entryNumber": 1,
"recordId": 910001,
"startDate": "2024-05-15",
"endDate": null
}
],
"homepage": [
"https://pilveaed.example"
],
"address": [
{
"address": {
"address": "Pilveaia tee 1",
"postalCode": "10111"
},
"cardNumber": 1,
"cardType": "R",
"entryNumber": 1,
"recordId": 910002,
"startDate": "2024-05-15",
"endDate": null
}
],
"searchRelatedPersons": [
{
"role": "JUHL",
"roleAsText": "Management board member",
"startDate": "2024-05-15",
"endDate": null,
"type": "F",
"firstName": "Mari",
"surnameLegalEntityName": "Maasikas",
"identityCode": "48503151233",
"birthday": "1985-03-15",
"foreignCode": null,
"foreignCodeCountry": null,
"foreignCodeCountryAsText": null,
"share": null
}
]
}
]
}
404 – Illustrative error response
This example illustrates the error structure; OpenAPI does not specify the meaning of code 4041.
{
"message": "Not found",
"code": 4041,
"id": null,
"timestamp": "2024-07-01T10:00:00Z"
}
422 – Illustrative validation error
GET /company/companyRelations?pageNumber=0
{
"detail": [
{
"loc": [
"query",
"pageNumber"
],
"msg": "Input should be greater than 0",
"type": "greater_than",
"input": 0,
"ctx": {
"gt": 0
}
}
]
}
Classifiers
| Code |
Name |
Category |
|---|
| A |
Founder |
Person not entered on the registry card |
| AJPH |
The interim trustee in bankruptcy acting as a liquidator |
Person entered on the registry card |
| AJUTPH |
Interim trustee |
Person entered on the registry card |
| ARP |
The registrar of the shares of the fund |
Person entered on the registry card |
| ASES |
Person with right to represent the agency |
Person entered on the registry card |
| B |
Founder |
Person not entered on the registry card |
| D |
Audit firm |
Person not entered on the registry card |
| DOKH |
Depositary of documents |
Person entered on the registry card |
| E |
Chairman of the supervisory board |
Person not entered on the registry card |
| ERIH |
Special regime trustee |
Person entered on the registry card |
| ESIS2 |
Person entitled to represent the undertaking |
Person entered on the registry card |
| EUSOS2 |
A limited partner authorized to represent |
Person entered on the registry card |
| FIE |
Sole trader |
Person entered on the registry card |
| FV |
The Management Company |
Person entered on the registry card |
| H |
Member of building association |
Person not entered on the registry card |
| HNKL |
Member of administrative board |
Person entered on the registry card |
| HUL |
Member of building association |
Person entered on the registry card |
| J |
Controller |
Person not entered on the registry card |
| JPNKR |
Trustee in bankruptcy with the right to supervise |
Person entered on the registry card |
| JUHL |
Management board member |
Person entered on the registry card |
| K |
Member of local authorities’ association |
Person not entered on the registry card |
| KISIK |
Contact person |
Person entered on the registry card |
| KOAS |
Superior agency |
Person entered on the registry card |
| L |
Member congregaton |
Person not entered on the registry card |
| LIKV |
Liquidator |
Person entered on the registry card |
| LIKVJ |
The liquidators are the members of the management board |
Person entered on the registry card |
| M |
Auditor of valuation of non-monetary contribution |
Person not entered on the registry card |
| MDKPI |
A person competent to receive procedural documents |
Person entered on the registry card |
| MORAH |
Trustee in moratorium |
Person entered on the registry card |
| N |
Member of the supervisory board |
Person not entered on the registry card |
| O |
Shareholder |
Person not entered on the registry card |
| ORP |
The registrar of the units of the fund |
Person entered on the registry card |
| OSAN |
Shareholder |
Person entered on the registry card |
| P |
Members of the bankruptcy committee |
Person not entered on the registry card |
| PANKR |
Trustee in bankruptcy |
Person entered on the registry card |
| PANTP |
Holder of the pledge |
Person entered on the registry card |
| PROK |
Procurator |
Person entered on the registry card |
| R |
Member of the auditing commission |
Person not entered on the registry card |
| RKL |
Member of the revision committee (Registry Card) |
Person entered on the registry card |
| S |
Stockholder |
Person not entered on the registry card |
| SJESI |
Legal representative of the company |
Person entered on the registry card |
| TOSAN |
General partner |
Person entered on the registry card |
| TVH |
Cover pool administrator |
Person entered on the registry card |
| UOSAN |
Limited partner |
Person entered on the registry card |
| V |
Authorised person |
Person not entered on the registry card |
| VALIT |
Administrator |
Person entered on the registry card |
| VFILJ |
Director of branch |
Person entered on the registry card |
| W |
Beneficial owner |
Person not entered on the registry card |
| YFI |
Acquiring natural person |
Person entered on the registry card |
| YHL |
The member of a commercial association |
Person entered on the registry card |
| YHLLV |
A member of association with additional liability |
Person entered on the registry card |
Statuses
| Code |
Name |
|---|
| K |
Deleted |
| L |
In liquidation |
| N |
In bankruptcy |
| R |
Entered into the register |
