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 } ] }