API endpoints
- https://api.bisnode.fi/company/info/v2/basicinfo - production environment
- https://api-test.bisnode.fi/company/info/v2/basicinfo - test environment
API request parameters
| Parameter | Description | |
|---|---|---|
| id | Business id or duns number | X |
| X = Mandatory | ||
GET https://api-test.bisnode.fi/company/info/v2/basicinfo/{id}
API response
| Element | Description |
|---|---|
| businessId | Company's business id |
| dunsNumber | Company's duns number |
| name | Name of the company |
| domicileMunicipalityCode | Code which indicates domicile municipality of the company. For descriptions see Codes API CodeKey = "MUC" |
| legalFormCode | For descriptions see Codes API CodeKey = "LFC" |
| languageCode | Company's language code. Available options: FI or SE. For descriptions see Codes API CodeKey = "LAC" |
| primaryLineOfBusinessCode | Code which indicates primary business line of the company. For descriptions see Codes API CodeKey = "LBC" |
| sectorCode | For descriptions see Codes API CodeKey = "SEC" |
| nationalUltimate_DUNSNumber | |
| companyStatusCode | Company's status code. For descriptions see Codes API CodeKey = "STC" |
| primaryPhoneNumber | Company's phone number. |
| addresses | Company's visiting and postal addresses. |
| officialAddresses | Company's official visiting and postal addresses. |
| primaryWebAddress | Company's primary web site address (URL) |
| primaryEmail | Company's primary email address |
| tradeNames | Company's auxiliary or parallel names |
| registers | Company's registers information. Contains elements: registerName, registered, startDate and endDate |
| parentCompany:name | Company's parent company. |
| parentCompany:countryCode | Company's parent company country code. For descriptions see Codes API CodeKey = "COC" |
| turnoverClassCode | Company's turnover class. For descriptions see Codes API CodeKey = "TUC" |
| personnelClassCode | Company's personnel class. For descriptions see Codes API CodeKey = "PEC" |
| leiCode | Company's LEI code |
| numberOfStocks | Number of stocks |
| capitalStock | Stock capital |
| nominalValueOfStocks | Nominal value of stocks |
| importIndicator | importIndicator |
| exportIndicator | exportIndicator |
| - | - |
API request and response example
curl 'https://api-test.bisnode.fi/company/info/v2/basicinfo/2014838-7' -H 'x-api-key: 1234567890ABC'
Successful request and the API return results in JSON format.
{
"businessId": "2014838-7",
"dunsNumber": "539506084",
"name": "Bisnode Finland Oy",
"domicileMunicipalityCode": "091",
"legalFormCode": "16",
"languageCode": "FI",
"primaryLineOfBusinessCode": "82910",
"sectorCode": "11103",
"nationalUltimate_DUNSNumber": "539506084",
"companyStatusCode": "100",
"primaryPhoneNumber": "09-75119100",
"addresses": [
{
"addressType": "PostalAddress",
"streetAddress": "Kumpulantie 3",
"postCode": "00520",
"postOffice": "HELSINKI"
},
{
"addressType": "VisitingAddress",
"streetAddress": "Kumpulantie 3",
"postCode": "00520",
"postOffice": "HELSINKI"
}
],
"officialAddresses": [
{
"officialAddressType": "PostalAddress",
"streetAddress": "Kumpulantie 3",
"postCode": "00520",
"postOffice": "HELSINKI"
},
{
"officialAddressType": "VisitingAddress",
"streetAddress": "Kumpulantie 3",
"postCode": "00520",
"postOffice": "HELSINKI"
}
],
"primaryWebAddress": "www.bisnode.fi",
"primaryEmail": "asiakaspalvelu@bisnode.com",
"tradeNames": [
{
"type": "Auxiliary",
"name": "Yritystele"
},
{
"type": "Auxiliary",
"name": "Bisnode Credit"
},
{
"type": "Auxiliary",
"name": "Soliditet Finland"
}
],
"registers": [
{
"registerName": "TradeRegister",
"registered": true,
"startDate": null,
"endDate": null
},
{
"registerName": "PrepaymentRegister",
"registered": true,
"startDate": "2006-02-01T00:00:00Z",
"endDate": null
},
{
"registerName": "VATLiabilityRegister",
"registered": true,
"startDate": "2006-02-01T00:00:00Z",
"endDate": null
},
{
"registerName": "EmployerRegister",
"registered": true,
"startDate": "2006-06-01T00:00:00Z",
"endDate": null
}
],
"parentCompany": {
"name": "Bisnode Ab",
"countryCode": "SE"
},
"turnoverClassCode": 8,
"personnelClassCode": 5,
"leiCode": ""
}