Endpoints
- https://api.bisnode.fi/company/info/v2/beneficialowners - production environment
- https://api-test.bisnode.fi/company/info/v2/beneficialowners - test environment
Request parameters
| Parameter | Description | |
|---|---|---|
| id | Company's business id or duns number | X |
| X = Mandatory | ||
GET https://api-test.bisnode.fi/company/info/v2/beneficialowners/{id}
Request and response example
curl 'https://api-test.bisnode.fi/company/info/v2/beneficialowners/2014838-7' -H 'x-api-key: 1234567890ABC'
Successful request and the API return results in JSON format.
{
"businessId": "2014838-7",
"dunsNumber": "539849657",
"typeCode": "ESR",
"noBeneficialOwners": false,
"registrationDate": null,
"expirationDate": null,
"beneficialOwners": [
{
"bisnodeId": "FI2101003159748",
"socialSecurityNumber": "110858-****",
"roleCode": "ES",
"firstName": "Katja Tiina Riitta",
"lastName": "Häkkilä",
"dateOfBirth": "1958-08-11T00:00:00Z",
"dateOfDeath": null,
"domicileCode": "564",
"homeCountryCode": "FI",
"nationalityCode": "FI",
"extentRegistrationDate": "2019-11-22T00:00:00Z",
"extentExpirationDate": null,
"ownershipExtent": 49,
"voteExtent": 49,
"otherBeneficialOwnership": false,
"businessProhibitionStartDate": null,
"businessProhibitionEndDate": null,
"businessProhibitionIsPartial": null,
"remarks": false,
"guardianship": false
},
{
"bisnodeId": "FI2101005198205",
"socialSecurityNumber": "031277-****",
"roleCode": "ES",
"firstName": "Eeva Minna",
"lastName": "Kangas",
"dateOfBirth": "1977-12-03T00:00:00Z",
"dateOfDeath": null,
"domicileCode": "564",
"homeCountryCode": "FI",
"nationalityCode": "FI",
"extentRegistrationDate": "2019-11-22T00:00:00Z",
"extentExpirationDate": null,
"ownershipExtent": 51,
"voteExtent": 51,
"otherBeneficialOwnership": false,
"businessProhibitionStartDate": null,
"businessProhibitionEndDate": null,
"businessProhibitionIsPartial": null,
"remarks": false,
"guardianship": false
}
],
"beneficialOwnersHistory": [],
"responsiblePersons": [
{
"bisnodeId": "FI2101005365812",
"socialSecurityNumber": "031175-****",
"dateOfBirth": "1975-11-03T00:00:00Z",
"firstNames": "Tomi Jaakko",
"lastName": "Ollila",
"nationality": "FI",
"roleCode": "HVJV",
"roleStartDate": "2011-10-07T00:00:00Z",
"roleEndDate": null
},
{
"bisnodeId": "FI2101003159748",
"socialSecurityNumber": "110858-****",
"dateOfBirth": "1958-08-11T00:00:00Z",
"firstNames": "Katja Tiina Riitta",
"lastName": "Häkkilä",
"nationality": "FI",
"roleCode": "HVJ",
"roleStartDate": "2011-10-07T00:00:00Z",
"roleEndDate": null
},
{
"bisnodeId": "FI2101005198205",
"socialSecurityNumber": "031277-****",
"dateOfBirth": "1977-12-03T00:00:00Z",
"firstNames": "Eeva Minna",
"lastName": "Kangas",
"nationality": "FI",
"roleCode": "TJ",
"roleStartDate": "2011-10-07T00:00:00Z",
"roleEndDate": null
},
{
"bisnodeId": "FI2101005198205",
"socialSecurityNumber": "031277-****",
"dateOfBirth": "1977-12-03T00:00:00Z",
"firstNames": "Eeva Minna",
"lastName": "Kangas",
"nationality": "FI",
"roleCode": "HPJ",
"roleStartDate": "2011-10-07T00:00:00Z",
"roleEndDate": null
}
]
}