Method: GET /person/representationRights

OpenAPI/Swagger: https://ar-rest.rik.ee/docs#/Person/get_representation_rights

Returns a person’s representation rights in companies – in which companies the person has representation rights, their role, sole representation right and special conditions of representation. The service allows checking a person’s representation rights across all companies at once. Suitable for representation right checks and background checks.

Query Parameters

Parameter	Type	Required	Description
personFirstName	string	Optional	First name of the related natural person. At least 2 characters (minLength: 2).
surnameLegalEntityName	string	Optional	Family name or business name. At least 2 characters (minLength: 2).
personBirthday	string (date)	Optional	Date of birth of the related natural person
personType	PersonType	Optional	Person Type: J - Juridical, P - Physical Default: P.
entityCode	string	Optional	Personal code or Company Code
entityCodeCountry	string	Optional	Country of the Entity Code (ISO 3166-1 alpha-3)
pageNumber	integer	Optional	Results Page Number. Default: 1. Maximum: 100000.
pageSize	integer	Optional	How many results on one page are desired. Default: 100. Maximum: 1000.

Header Parameters

Parameter	Type	Required	Description
apiVersion	ApiVersions	Optional	Api version header Default: V1.
acceptLanguage	AcceptLanguage	Optional	Language of translations of classifiers (est-Estonian, eng-English) Default: est.

Responses

Successful request – Mari Maasikas may represent the company alone.

{
 "total": 1,
 "list": [
 {
 "legalEntityName": "NÄIDIS OÜ",
 "registryCode": 12345678,
 "persons": [
 {
 "firstName": "Mari",
 "surnameLegalEntityName": "Maasikas",
 "entityCode": "48503151233",
 "entityCodeCountry": "EST",
 "birthday": "1985-03-15",
 "personType": "F",
 "role": "JUHL",
 "roleAsText": "Management board member",
 "exclusiveRightOfRepresentation": true,
 "entityCodeCountryAsText": "Estonia"
 }
 ],
 "representationRightSpecialConditions": [],
 "representationRightGroups": [],
 "legalForm": "5",
 "legalFormAsText": "Private limited company",
 "status": "R",
 "statusAsText": "Registered"
 }
 ]
}

Successful request – Jüri Juurikas may represent the company alone; Anna Aedmaasikas and Erik Esimerkki may represent it jointly.

{
 "total": 1,
 "list": [
 {
 "legalEntityName": "SUUR ETTEVÕTE AS",
 "registryCode": 10000001,
 "persons": [
 {
 "firstName": "Jüri",
 "surnameLegalEntityName": "Juurikas",
 "entityCode": "38006201232",
 "entityCodeCountry": "EST",
 "birthday": "1980-06-20",
 "personType": "F1",
 "role": "JUHL",
 "roleAsText": "Management board member",
 "exclusiveRightOfRepresentation": true,
 "entityCodeCountryAsText": "Estonia"
 },
 {
 "firstName": "Anna",
 "surnameLegalEntityName": "Aedmaasikas",
 "entityCode": "49011251238",
 "entityCodeCountry": "EST",
 "birthday": "1990-11-25",
 "personType": "F1",
 "role": "JUHL",
 "roleAsText": "Management board member",
 "exclusiveRightOfRepresentation": false,
 "entityCodeCountryAsText": "Estonia"
 },
 {
 "firstName": "Erik",
 "surnameLegalEntityName": "Esimerkki",
 "entityCode": "FI-EXAMPLE-001",
 "entityCodeCountry": "FIN",
 "birthday": "1988-08-12",
 "personType": "F2",
 "role": "JUHL",
 "roleAsText": "Management board member",
 "exclusiveRightOfRepresentation": false,
 "entityCodeCountryAsText": "Finland"
 }
 ],
 "representationRightSpecialConditions": [
 "The company may be represented by Jüri Juurikas alone or by Anna Aedmaasikas and Erik Esimerkki jointly."
 ],
 "representationRightGroups": [
 {
 "groupNumber": 1,
 "persons": [
 {
 "firstName": "Anna",
 "surnameLegalEntityName": "Aedmaasikas",
 "entityCode": "49011251238",
 "entityCodeCountry": "EST",
 "birthday": "1990-11-25",
 "personType": "F",
 "role": "JUHL",
 "roleAsText": "Management board member",
 "exclusiveRightOfRepresentation": false,
 "entityCodeCountryAsText": "Estonia"
 },
 {
 "firstName": "Erik",
 "surnameLegalEntityName": "Esimerkki",
 "entityCode": "FI-EXAMPLE-001",
 "entityCodeCountry": "FIN",
 "birthday": "1988-08-12",
 "personType": "F",
 "role": "JUHL",
 "roleAsText": "Management board member",
 "exclusiveRightOfRepresentation": false,
 "entityCodeCountryAsText": "Finland"
 }
 ]
 }
 ],
 "legalForm": "1",
 "legalFormAsText": "Public limited company",
 "status": "R",
 "statusAsText": "Registered"
 }
 ]
}

No data matching the request was found.

Service access denied.

Resource was not found.

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

Invalid request – parameters do not meet the requirements.

{
 "detail": [
 {
 "loc": ["query", "personFirstName"],
 "msg": "String should have at least 2 characters",
 "type": "string_too_short"
 }
 ]
}

Response Schema

RepresentationRightsResponse

Field	Type	Description
total	integer	Required.
list	array[CompanyRepresentationRights]	Required. Entrepreneurs

CompanyRepresentationRights

Field	Type	Description
legalEntityName	string	Required. Company business name
registryCode	integer	Required. Company registration code
representationRightSpecialConditions	array[string]	Special conditions for the right of representation
representationRightGroups	array[RepresentationRightsGroup]	Representation right groups and their joint representation rules
persons	array[RepresentationRightsPerson]	Required. Persons with the right of representation
legalForm	string	Required. Legal form
legalFormAsText	string	Required. Legal form as text
status	string	Required. State
statusAsText	string	Required. State as text

RepresentationRightsGroup

Field	Type	Description
groupNumber	integer	Required. Group number
persons	array[RepresentationRightsPerson]	Required. Persons in the group

RepresentationRightsPerson

Field	Type	Description
firstName	string | null	First name
surnameLegalEntityName	string	Required. Family name or Business name
entityCode	string | null	Personal code or Company Code
entityCodeCountry	string	Required. Country of the Entity Code (ISO 3166-1 alpha-3)
entityCodeCountryAsText	string | null	Country name of the personal or company code. Optional.
birthday	string (date) | null	Date of birth
personType	string	Required. Person Type
role	string	Required. Role of the person
roleAsText	string	Required. Role as Text
exclusiveRightOfRepresentation	boolean | null	Existence of exclusive right of representation

JSON Schema

{
 "RepresentationRightsResponse": {
 "type": "object",
 "required": ["total", "list"],
 "properties": {
 "total": {
 "type": "integer",
 "description": "Total number of companies found"
 },
 "list": {
 "type": "array",
 "items": { "$ref": "#/components/schemas/CompanyRepresentationRights" },
 "description": "List of companies"
 }
 }
 },
 "CompanyRepresentationRights": {
 "type": "object",
 "required": ["legalEntityName", "registryCode", "persons", "legalForm", "legalFormAsText", "status", "statusAsText"],
 "properties": {
 "legalEntityName": { "type": "string" },
 "registryCode": { "type": "integer" },
 "representationRightSpecialConditions": { "type": "array", "items": { "type": "string" } },
 "representationRightGroups": { "type": "array", "items": { "$ref": "#/components/schemas/RepresentationRightsGroup" } },
 "persons": { "type": "array", "items": { "$ref": "#/components/schemas/RepresentationRightsPerson" } },
 "legalForm": { "type": "string" },
 "legalFormAsText": { "type": "string" },
 "status": { "type": "string" },
 "statusAsText": { "type": "string" }
 }
 },
 "RepresentationRightsGroup": {
 "type": "object",
 "required": ["groupNumber", "persons"],
 "properties": {
 "groupNumber": { "type": "integer" },
 "persons": { "type": "array", "items": { "$ref": "#/components/schemas/RepresentationRightsPerson" } }
 }
 },
 "RepresentationRightsPerson": {
 "type": "object",
 "required": ["surnameLegalEntityName", "entityCodeCountry", "personType", "role", "roleAsText"],
 "properties": {
 "firstName": { "anyOf": [{ "type": "string" }, { "type": "null" }] },
 "surnameLegalEntityName": { "type": "string" },
 "entityCode": { "anyOf": [{ "type": "string" }, { "type": "null" }] },
 "entityCodeCountry": { "type": "string" },
 "entityCodeCountryAsText": { "anyOf": [{ "type": "string" }, { "type": "null" }] },
 "birthday": { "anyOf": [{ "type": "string", "format": "date" }, { "type": "null" }] },
 "personType": { "type": "string" },
 "role": { "type": "string" },
 "roleAsText": { "type": "string" },
 "exclusiveRightOfRepresentation": { "anyOf": [{ "type": "boolean" }, { "type": "null" }] }
 }
 }
}

e-Business Register team · e-Business Register REST API documentation