getShareholdersAndOtherRoles

post
getShareholdersAndOtherRoles

https://in.bisnode.ee/rest/getShareholdersAndOtherRoles
This endpoint allows you to get company current and previous owners, shareholders and other connected persons, such as members of supervisory board, auditors. Example request: { "token": "0c725874e737c8195de547f67692d8b976726561", "reg_code": "10117826", "country": "EST", }
Request
Response
Request
Query Parameters
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
[
{
"role": "Stockholder",
"role_code": "S",
"information_source": "NASDAQ andmed",
"authority_end_date": null,
"start_date": "2011-11-11",
"end_date": null,
"revision_date": null,
"control_source": null,
"control_source_code": null,
"control_source_date": null,
"group": null,
"created_at": "2018-09-13 17:05:17",
"updated_at": "2018-09-13 17:05:17",
"active": "active",
"on_card": false,
"code": "11111111",
"person_birth_date": null,
"person_gener": null,
"country": "EST",
"name": "Aktsiaselts ABC",
"type": "Juridical person",
"type_code": "J",
"ownership": "Simple ownership",
"ownership_code": "L",
"share_capital_amount": "1111111.11",
"share_capital_currency": "EUR",
"share_capital_percent": "100.00",
"trade_ban": null,
"tags": []
},
{
"role": "Chairman of the supervisory board",
"role_code": "E",
"information_source": null,
"authority_end_date": null,
"start_date": "2011-11-11",
"end_date": null,
"revision_date": null,
"control_source": "Electronically submitted (entry) statement",
"control_source_code": null,
"control_source_date": null,
"group": null,
"created_at": "2018-09-13 17:05:17",
"updated_at": "2018-09-13 17:05:17",
"active": "active",
"on_card": false,
"code": "11111111111",
"person_birth_date": "1955-11-11",
"person_gener": "M",
"country": "EST",
"name": "Karl Karll",
"type": "Physical person",
"type_code": "F",
"ownership": null,
"ownership_code": null,
"share_capital_amount": null,
"share_capital_currency": null,
"share_capital_percent": null,
"trade_ban": null,
"tags": []
}
]
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"
}