Bisnode API

getting started

API Reference
We are the leading provider of data and analytics in Europe. Our APIs allow you to easily access and integrate our data and insight into your own systems.
The Bisnode Estonia API is organized around REST. You can use this API to access all our API endpoints listed below. All requests should be made over SSL. All request and response bodies, including errors, are encoded in JSON. 
Needed headers: Content-type: application/json
Authentication
Most requests to Bisnode Estonia API server require 'access token'(API key) to authenticate requests. To get 'access token'(API key) please contact us: 
🖂 info@bisnode.ee
🕿 +372 6414 902
Rate limiting
We don't allow multiple identical synchronous (parallel) requests, otherwise you will get "Parallel request blocked" 423 error. For example, you can't send two searchCompany requests at one time, you will have to wait for the first searchCompany request to complete.
Available requests
🛈 General information (4)
Request
Response
​getCompanyInformation             
Company name, country, registration number, registration date, legal form, legal status, main activity code, address, vat number etc.
​getContacts​
Postal address, phone, e-mail, webpage.
​getAaaRatingWithHistory​
Current AAA rating and rating history.
​searchCompany​
Company name, country, registration number, address.

🛇 Negative information (3)
Request
Response
​getTaxArrears​
Current tax arrears and tax arrears history for two years.
​getPublicAnnouncements  
Enforcement notices, court decisions on debt for two years.
​getDebtCollectionCases​
Debt collection cases for two years.

☺ Persons in company (3)
Request
Response
​getManagementBoard                
Current and previous members of management board, company representation rights.
​getShareholdersAndOtherRoles​
Current and previous owners of the company, other connected persons such as members of supervisory board, auditors.
​getBeneficialOwner​
Beneficial owner is currently determined using Bisnode’s Estonian company database. Foreign beneficial owners may not be found.

💰 Financial information (4)
Request
Response
​getFinancialInformation              
Key financial indicators: Revenue, Profit/Loss, Equity, Short-term liabilities etc.
​getFinancialStatements​
Full income statement, balance sheet and cash flows.
​getTaxInformation​
Quarterly information about paid state and labor tax, revenue and number of employees from Tax Authority.
​getSalaryInformation​
Average salary paid in company and its comparison to the industry.

🏠 Real Estate (1)
Request
Response
​getImmovables                          
Includes information about real estate of a company or a person.

🖹 Credit reports (2)
Request
Response
​getCreditReport                             
Includes full information about a company needed to make fully informed credit decision.
​getPersonReport​
Includes various information about a person to evaluate trustworthiness of a person.

🛠 Tools (1)
Request
Response
​Personal code validator                       
Here you can validate a personal identification code and extract personal information from it.

🗹 Customized API request (*)
We offer customized API request based on data you need. Please contact us and let’s discuss how we can make the best solution for you: 🖂 info@bisnode.ee or 🕿 +372 6414 902
Errors
Our API returns standard HTTP success or error status codes. For errors, we will also include extra information about what went wrong encoded in the response as JSON. The various HTTP status codes we might return are listed below.

HTTP Status codes
Code
Title
Description
200
OK
The request was successful.
400
Bad request
Bad request.
401
Unauthorized
Your token (API key) is invalid.
402
Payment required
Monthly requests limit is exceeded.
403
Forbidden
This request is not allowed for you.
404
Not found
The resource does not exist.
409
Conflict
Something went wrong.
422
Unprocessable Entity
A validation error occurred.
423
Locked
Parallel request is blocked.
500
Internal Server Error
An error occurred with our API.
Example error response.
400: Bad Request
​
{
    "error": "error",
    "code": 400,
    "message": "Only EST and LVA countries are supported in this request"
}

Pricing

Last updated 2 months ago

Request	Response
getCompanyInformation	Company name, country, registration number, registration date, legal form, legal status, main activity code, address, vat number etc.
getContacts	Postal address, phone, e-mail, webpage.
getAaaRatingWithHistory	Current AAA rating and rating history.
searchCompany	Company name, country, registration number, address.

Request	Response
getTaxArrears	Current tax arrears and tax arrears history for two years.
getPublicAnnouncements	Enforcement notices, court decisions on debt for two years.
getDebtCollectionCases	Debt collection cases for two years.

Request	Response
getManagementBoard	Current and previous members of management board, company representation rights.
getShareholdersAndOtherRoles	Current and previous owners of the company, other connected persons such as members of supervisory board, auditors.
getBeneficialOwner	Beneficial owner is currently determined using Bisnode’s Estonian company database. Foreign beneficial owners may not be found.

Request	Response
getFinancialInformation	Key financial indicators: Revenue, Profit/Loss, Equity, Short-term liabilities etc.
getFinancialStatements	Full income statement, balance sheet and cash flows.
getTaxInformation	Quarterly information about paid state and labor tax, revenue and number of employees from Tax Authority.
getSalaryInformation	Average salary paid in company and its comparison to the industry.

Request	Response
getImmovables	Includes information about real estate of a company or a person.

Request	Response
getCreditReport	Includes full information about a company needed to make fully informed credit decision.
getPersonReport	Includes various information about a person to evaluate trustworthiness of a person.

Request	Response
Personal code validator	Here you can validate a personal identification code and extract personal information from it.

Code	Title	Description
200	OK	The request was successful.
400	Bad request	Bad request.
401	Unauthorized	Your token (API key) is invalid.
402	Payment required	Monthly requests limit is exceeded.
403	Forbidden	This request is not allowed for you.
404	Not found	The resource does not exist.
409	Conflict	Something went wrong.
422	Unprocessable Entity	A validation error occurred.
423	Locked	Parallel request is blocked.
500	Internal Server Error	An error occurred with our API.