Dun & Bradstreet Estonia API

getting started

API Reference

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 Dun & Bradstreet 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

Authentication

Request authentication to Dun & Bradstreet Estonia API server requires 'access token'(API key) in most cases. To get 'access token'(API key), contact us: 🖂 [e-mail] 🕿 [phone]

Rate limiting

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.

Available requests

🛈 General information (5)

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.
getCompanyUpdateDate	Latest update date of given company.

🛇 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 the 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 by using Estonia company database. Foreign beneficial owners may not be found.

💰 Financial information (6)

Request	Response
listAnnualReport	Returns list of available annual report documents (PDF, XBRL, BDOC) from Äriregister.
getAnnualReport	General Information, balance sheet, income statement, cash flows, salary expense, net sales by activity.
getFinancialInformation	Key financial indicators: Revenue, Profit/Loss, Equity, Short-term liabilities etc.
getFinancialStatements	Full income statement, balance sheet and cash flows.
getTaxInformation	Quarterly based information about the paid state, labor tax, revenue, and number of employees from the Tax Authority.
getSalaryInformation	Average salary which is paid by the 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
getCreditReportTranslated	Includes all information about a company that is needed to make fully informed credit decision.
getPersonReportTranslated	Includes various information about a person to evaluate trustworthiness of a person.

👓 Personal information(1)

Request	Response
getPersonInformation	Includes general person information: personal code, first and last name, previous names(if exist), death date(if exists), personal address.

🛠 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 requests which are based on data you need. For discussion about how to provide a best solution for you, contact us: 🖂 [e-mail] or 🕿 [phone]

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