Company rest API

Basic information

The API returns company's basic information (e.g. contacts and duns-number) in JSON format, as specified by business id or duns number.

In order to use the API you must have the valid environment-specific username and password. Before any API requests, you need to obtain an API KEY. You will get a valid API KEY (it's called a ticket) by using the ticket API (Please, read how to use ticket API instructions).

The API KEY must be sent in the request custom header element (named ticket or x-api-key). If the API KEY value is valid then API request will be successful (http status code 200), otherwise it will fail (http status code 401). All API requests must be made over HTTPS.

Request the username and password

Endpoints

https://api.bisnode.fi/company/info/v2/basicinfo - production environment
https://api-test.bisnode.fi/company/info/v2/basicinfo - test environment

Request parameters

Parameter	Description
id	Business id or duns number	X
X = Mandatory

GET https://api-test.bisnode.fi/company/info/v2/basicinfo/{id}

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

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",
"companyStatusCode": "100",
"primaryPhoneNumber": "09-75119100",
"primaryWebAddress": "www.bisnode.fi",
"primaryEmail": "[email protected]",
"leiCode": "",
"turnoverClassCode": 8,
"personnelClassCode": 5,
"numberOfStocks": 100,
"capitalStock": 8500,
"nominalValueOfStocks": 85,
"exporter": false,
"importer": false,
"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"
}
],
"tradeNames": [
{
"type": "Auxiliary",
"name": "Soliditet Finland"
},
{
"type": "Auxiliary",
"name": "Bisnode Credit"
},
{
"type": "Auxiliary",
"name": "Yritystele"
}
],
"registers": [
{
"registerName": "TradeRegister",
"registered": true,
"startDate": "2006-02-13T00:00:00Z",
"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": {
"businessId": "",
"dunsNumber": "356152074",
"name": "Bisnode Ab",
"countryCode": "SE"
},
"nationalUltimateCompany": {
"businessId": "2014838-7",
"dunsNumber": "539506084",
"name": "Bisnode Finland Oy"
}
}

SWAGGER - Developer REST API documentation - read more

Please note that data coverage varies between companies. Data coverage depends e.g. on company form. Remember the codes and descriptions API returns all companies REST APIs code values and descriptions - read more.