Bisnode Estonia API
getting started
We are a Dun & Bradstreet company, a leading global provider of business decisioning data and analytics for almost 200 years. Our APIs allow you to easily access and integrate our data and insight into your own systems.
The Bisnode Estonia API is organized around Representational State Transfer (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
Request authentication to Bisnode Estonia API server requires 'access token'(API key) in most cases. To get 'access token'(API key), contact us:
🖂 [email protected]
🕿 +372 6414 902
We do not allow multiple identical synchronous (parallel) requests, otherwise you will get "Parallel request blocked" 423 error. For example, you can not send two searchCompany requests at the same time. To proceed with the second request, you have to wait for the first one to be completed.
Request | Response |
Company name, country, registration number, registration date, legal form, legal status, main activity code, address, vat number etc. | |
Postal address, phone, e-mail, webpage. | |
Current AAA rating and rating history. | |
Company name, country, registration number, address. | |
Latest update date of given company. |
Request | Response |
Current tax arrears and tax arrears history for two years. | |
Enforcement notices, court decisions on debt for two years. | |
Debt collection cases for two years. |
Request | Response |
Current and previous members of the management board, company representation rights. | |
Current and previous owners of the company, other connected persons such as members of supervisory board, auditors. | |
Beneficial owner is currently determined by using Bisnode’s Estonian company database. Foreign beneficial owners may not be found. |
Request | Response |
Returns list of available annual report documents (PDF, XBRL, BDOC) from Äriregister. | |
General Information, balance sheet, income statement, cash flows, salary expense, net sales by activity. | |
Key financial indicators: Revenue, Profit/Loss, Equity, Short-term liabilities etc. | |
Full income statement, balance sheet and cash flows. | |
Quarterly based information about the paid state, labor tax, revenue, and number of employees from the Tax Authority. | |
Average salary which is paid by the company and its comparison to the industry. |
Request | Response |
Includes information about real estate of a company or a person. |
Request | Response |
Includes all information about a company that is needed to make fully informed credit decision. | |
Includes various information about a person to evaluate trustworthiness of a person. |
Request | Response |
Includes general person information: personal code, first and last name, previous names(if exist), death date(if exists), personal address. |
Request | Response |
Here you can validate a personal identification code and extract personal information from it. |
We offer customized API requests which are based on data you need. For discussion about how to provide a best solution for you, contact us: 🖂 [email protected] or 🕿 +372 6414 902
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.
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"
}
Last modified 1yr ago