Developers
  • Dun & Bradstreet Estonia API
  • Test environment
  • Pricing
  • Contact
  • General information
    • searchCompany
    • getCompanyInformation
    • getContacts
    • getAaaRatingWithHistory
    • getCompanyUpdateDate
  • Negative information
    • getTaxArrears
    • getPublicAnnouncements
    • getDebtCollectionCases
  • Persons in company
    • getManagementBoard
    • getShareholdersAndOtherRoles
    • getBeneficialOwner
  • Financial information
    • listAnnualReport
    • getAnnualReport
    • getFinancialInformation
    • getFinancialStatements
    • getTaxInformation
    • getSalaryInformation
  • REAL ESTATE
    • getImmovables
  • Credit reports
    • Company credit report
    • Person credit report
  • Personal Information
    • getPersonInformation
  • TOOLS
    • Person code validator
  • International data
    • BBC API
  • User
    • getProfile
    • getLimits
Powered by GitBook
On this page

Was this helpful?

  1. Persons in company

getBeneficialOwner

TEST request - https://in.bisnode.ee/rest_dev/getBeneficialOwner

getBeneficialOwner

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" }'

Query Parameters

Name
Type
Description

language

string

2-letter language code. Must be "en", "et" or "ru". Default is "en".

token

string

Your 'access token' (API key).

reg_code

string

Company registration number.

country

string

3-letter country code "EST" or "LVA". Default is "EST".

{
    "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"
        }
    ]
}
{
    "error": "error",
    "code": 400,
    "message": "Only EST and LVA countries are supported in this request"
}
{
    "error": "error",
    "code": 401,
    "message": "Token is wrong"
}
{
    "error": "error",
    "code": 402,
    "message": "Monthly requests limit exceeded"
}
{
    "error": "error",
    "code": 403,
    "message": "This request is not allowed for you"
}
{
    "error": "error",
    "code": 404,
    "message": "No such company"
}
{
    "error": "error",
    "code": 409,
    "message": "Something went wrong"
}
{
    "error": "error",
    "code": 422,
    "message": "Schema validation error"
}
{
    "error": "error",
    "code": 423,
    "message": "Locked. Wait for previous request to complete"
}
{
    "error": "error",
    "code": 500,
    "message": "Internal Server Error"
}
PreviousgetShareholdersAndOtherRolesNextlistAnnualReport

Last updated 4 years ago

Was this helpful?