getBeneficialOwner
TEST request - https://in.bisnode.ee/rest_dev/getBeneficialOwner
postgetBeneficialOwner
post
https://in.bisnode.ee/rest/getBeneficialOwner
Needed Headers: Content-type: application/json
This endpoint allows you to get company beneficial owners.
Beneficial owner is currently determined using Bisnode’s Estonian company database. Foreign beneficial owners may not be found.
Example Curl request:
curl -X POST -k -H 'Content-type: application/json' -i 'https://in.bisnode.ee/rest/getBeneficialOwner' --data '{
"token": "0c725874e737c8195de547f67692d8b976726561",
"reg_code": "10117826",
"country": "EST",
"language": "en"
}'Request
Response
Request
Query Parameters
language
optional
string
2-letter language code. Must be "en", "et" or "ru". Default is "en".
token
required
string
Your 'access token' (API key).
reg_code
required
string
Company registration number.
country
optional
string
3-letter country code "EST" or "LVA". Default is "EST".
Response
200: OK
{"reg_code": "11111111","business_name": "ABC invest","beneficial_owners": [{"id": "11111","full_name": "Karl Karll","full_name_normalized": "Karl Karll","code": "11111111111","person_gender": "M","birth_date": "1960-12-12","code_origin": "EST","type": "person","address": null,"created_at": "2014-05-09 00:00:00","updated_at": "2018-01-22 12:09:00","beneficial_owner_type": "direct"},{"id": "11112","full_name": "Aivar Aivo","full_name_normalized": "Aivar Aivo","code": "22222222222","person_gender": "M","birth_date": "1970-08-08","code_origin": "EST","type": "person","address": "Tartu linn, Tartu maakond, Eesti Vabariik","created_at": "2014-09-09 00:00:00","updated_at": "2019-01-25 11:16:05","beneficial_owner_type": "indirect"}]}
400: Bad Request
Invalid country code
{"error": "error","code": 400,"message": "Only EST and LVA countries are supported in this request"}
401: Unauthorized
Invalid token
{"error": "error","code": 401,"message": "Token is wrong"}
402: Payment Required
Not enough credit
{"error": "error","code": 402,"message": "Monthly requests limit exceeded"}
403: Forbidden
{"error": "error","code": 403,"message": "This request is not allowed for you"}
404: Not Found
Could not find a company matching this query
{"error": "error","code": 404,"message": "No such company"}
409: Conflict
{"error": "error","code": 409,"message": "Something went wrong"}
422: Unprocessable Entity
Validation failed
{"error": "error","code": 422,"message": "Schema validation error"}
423: Locked
{"error": "error","code": 423,"message": "Locked. Wait for previous request to complete"}
500: Internal Server Error
{"error": "error","code": 500,"message": "Internal Server Error"}