# 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](http://en.wikipedia.org/wiki/Representational_State_Transfer)). 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](https://docs.bisnode.ee/www.json.org). \ \ **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: \ 🖂 ****\ 🕿 **+372 6414 902** ## 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**](https://docs.bisnode.ee/general-information/getcompanyinformation) | Company name, country, registration number, registration date, legal form, legal status, main activity code, address, vat number etc. | | [**getContacts**](https://docs.bisnode.ee/general-information/getcontacts) | Postal address, phone, e-mail, webpage. | | [**getAaaRatingWithHistory**](https://docs.bisnode.ee/general-information/getaaaratingwithhistory) | Current AAA rating and rating history. | | [**searchCompany**](https://docs.bisnode.ee/general-information/searchcompany) | Company name, country, registration number, address. | | [**getCompanyUpdateDate**](https://docs.bisnode.ee/general-information/getcompanyupdatedate) | Latest update date of given company. | ### 🛇 Negative information (3) | Request | Response | | ------------------------------------------------------------------------------------------------- | ----------------------------------------------------------- | | [**getTaxArrears**](https://docs.bisnode.ee/negative-information/gettaxarrears) | Current tax arrears and tax arrears history for two years. | | [**getPublicAnnouncements**](https://docs.bisnode.ee/negative-information/getpublicannouncements) | Enforcement notices, court decisions on debt for two years. | | [**getDebtCollectionCases**](https://docs.bisnode.ee/negative-information/getdebtcollectioncases) | Debt collection cases for two years. | ### ☺ Persons in company (3) | Request | Response | | ------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------- | | [**getManagementBoard**](https://docs.bisnode.ee/persons-in-company/getmanagementboard) | Current and previous members of the management board, company representation rights. | | [**getShareholdersAndOtherRoles**](https://docs.bisnode.ee/persons-in-company/getshareholdersandroles) | Current and previous owners of the company, other connected persons such as members of supervisory board, auditors. | | [**getBeneficialOwner**](https://docs.bisnode.ee/persons-in-company/getbeneficialowner) | Beneficial owner is currently determined by using Estonia company database. Foreign beneficial owners may not be found. | ### 💰 Financial information (6) | Request | Response | | ---------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- | | [**listAnnualReport**](https://docs.bisnode.ee/financial-information/listannualreport) | Returns list of available annual report documents (PDF, XBRL, BDOC) from Äriregister. | | [**getAnnualReport**](https://docs.bisnode.ee/financial-information/getannualreport) | General Information, balance sheet, income statement, cash flows, salary expense, net sales by activity. | | [**getFinancialInformation**](https://docs.bisnode.ee/financial-information/getfinancialinformation) | Key financial indicators: Revenue, Profit/Loss, Equity, Short-term liabilities etc. | | [**getFinancialStatements**](https://docs.bisnode.ee/financial-information/getfinancialstatements) | Full income statement, balance sheet and cash flows. | | [**getTaxInformation**](https://docs.bisnode.ee/financial-information/gettaxinformation) | Quarterly based information about the paid state, labor tax, revenue, and number of employees from the Tax Authority. | | [**getSalaryInformation**](https://docs.bisnode.ee/financial-information/getsalaryinformation) | Average salary which is paid by the company and its comparison to the industry. | ### 🏠 Real Estate (1) | Request | Response | | ---------------------------------------------------------------------- | ---------------------------------------------------------------- | | [**getImmovables**](https://docs.bisnode.ee/real-estate/getimmovables) | Includes information about real estate of a company or a person. | ### 🖹 Credit reports (2) | Request | Response | | ------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------- | | [**getCreditReportTranslated**](https://docs.bisnode.ee/credit-reports/companycreditreport) | Includes all information about a company that is needed to make fully informed credit decision. | | [**getPersonReportTranslated**](https://docs.bisnode.ee/credit-reports/personcreditreport) | Includes various information about a person to evaluate trustworthiness of a person. | ### 👓 Personal information(1) | Request | Response | | --------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- | | [**getPersonInformation**](https://docs.bisnode.ee/personal-information/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**](https://docs.bisnode.ee/tools/personalcodevalidator) | 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: 🖂 **** 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. ```javascript 400: Bad Request { "error": "error", "code": 400, "message": "Only EST and LVA countries are supported in this request" } ``` # Test environment You can test any API request you want using test Token. Link to test endpoint is shown under request name. Example CURL request: ``` curl -X POST -k -H 'Content-type: application/json' -i 'https://in.bisnode.ee/rest_dev/getContacts' -data '{ "token": "v9988f42c0eza7e824998365c1c868e3", "reg_code": "10117826", "country": "EST" }' ``` Change API request URL ('' in the example) to API request URL you want to test and input parameters, if needed. Contact us for test Token:\ 🖂 ****\ 🕿 **+372 6414 902 (EST, ENG)** # Pricing We offer flexible pricing options for Dun & Bradstreet Estonia API users. Fixed monthly fee and pay-by-request options are available.� Contact us for price offer:\ 🖂 ****\ 🕿 **+372 6414 902 (EST, ENG)** ### **Tips** * For quickest reply please specify request(s) you’re interested in using and approximate volumes per month. * If you cannot find suitable API from our list please describe the solution you need. We have built a lot of custom APIs. � # Contact Dun & Bradstreet Estonia AS\ Postal address: Pronksi 12, Tallinn 10117\ [Google maps](https://www.google.com/maps/place/Bisnode+Estonia+AS/@59.429472,24.7330033,17z/data=!3m1!4b1!4m5!3m4!1s0x469293603d53eb33:0x2b498878c493a62d!8m2!3d59.429472!4d24.735192) Registry code: 10117826 [Email contact form](https://www.bisnode.ee/bisnode-public-api/) 🖂 ****\ 🕿 **+372 6414 902** # searchCompany TEST request - https\://in.bisnode.ee/rest\_dev/searchCompany ## searchCompany `POST` `https://in.bisnode.ee/rest/searchCompany` **Needed Headers:** Content-type: application/json\ \ This endpoint allows you to search for company by `'name'` and `'country'`\ You will get such information as: \ `* Business name`\ `* Registration number`\ `* Address`\ `* Country`\ \ Example Curl request:\ `curl -X POST -k -H 'Content-type: application/json' -i 'https://in.bisnode.ee/rest/searchCompany' --data '{` \ `"token": "0c725874e737c8195de547f67692d8b976726561",` \ `"name": "Bisnode",` \ `"country": "EST",` \ `"language": "en"` \ `}'`
#### Query Parameters | Name | Type | Description | | -------- | ------ | ----------------------------------------------------------------------- | | language | string | 2-letter language code. Must be "en", "et" or "ru". Default is "en". | | token | string | Your 'access token' (API key). | | name | string | Company name or registration number. | | country | string | 3-letter country code. Must be "EST", "LTU" or "LVA". Default is "EST". | {% tabs %} {% tab title="200 Response successfully retrieved" %} ```javascript [ { "country": "EST", "registration_number": "10117826", "business_name": "BISNODE ESTONIA AS", "main_address": "Endla tn 15, 10122, Tallinn, Harju maakond, Eesti Vabariik" } ] ``` {% endtab %} {% tab title="400 Invalid country code" %} ```javascript { "error": "error", "code": 400, "message": "Country code is wrong. Must be EST LTU or LVA" } ``` {% endtab %} {% tab title="401 Invalid token" %} ```javascript { "error": "error", "code": 401, "message": "Token is wrong" } ``` {% endtab %} {% tab title="402 Not enough credit" %} ```javascript { "error": "error", "code": 402, "message": "Monthly requests limit exceeded" } ``` {% endtab %} {% tab title="403 " %} ```javascript { "error": "error", "code": 403, "message": "This request is not allowed for you" } ``` {% endtab %} {% tab title="404 Could not find a company matching this query" %} ```javascript { "error": "error", "code": 404, "message": "No such company" } ``` {% endtab %} {% tab title="409 " %} ```javascript { "error": "error", "code": 409, "message": "Internal Server Error" } ``` {% endtab %} {% tab title="422 Validation failed" %} ```javascript { "error": "error", "code": 422, "message": "Schema validation error" } ``` {% endtab %} {% tab title="423 " %} ```javascript { "error": "error", "code": 423, "message": "Locked. Wait for previous request to complete" } ``` {% endtab %} {% tab title="500 " %} ```javascript { "error": "error", "code": 500, "message": "Internal Server Error" } ``` {% endtab %} {% endtabs %} # getCompanyInformation TEST request - https\://in.bisnode.ee/rest\_dev/getCompanyInformation ## getCompanyInformation `POST` `https://in.bisnode.ee/rest/getCompanyInformation` **Needed Headers:** Content-type: application/json\ \ This endpoint allows you to get general company information such as: \ `* Company name`\ `* Company type`\ `* Company type code`\ `* Company status`\ `* Company status code`\ `* Company deletion date (if deleted)`\ `* Registration number`\ `* Registration date`\ `* Registered capital`\ `* VAT number`\ `* Address`\ `* Activity NACE code`\ `* Activity description`\ `* Country`\ \ Example Curl request:\ `curl -X POST -k -H 'Content-type: application/json' -i 'https://in.bisnode.ee/rest/getCompanyInformation' --data '{`\ `"token": "0c725874e737c8195de547f67692d8b976726561",`\ `"reg_code": "10117826",`\ `"country": "EST",`\ `"language": "en"`\ `}'` #### Query Parameters | Name | Type | Description | | --------- | ------ | -------------------------------------------------------------------- | | language | string | 2-letter language code. Must be "en", "et" or "ru". Default is "en". | | token | string | Your 'access token' (API key). | | reg\_code | string | Company registration number. | | country | string | 3-letter country code "EST", "LVA" or "LTU". Default is "EST". | {% tabs %} {% tab title="200 Response successfully retrieved" %} ```javascript { "company_id": "264421", "company_name": "BISNODE ESTONIA AS", "company_type": "Public limited company", "company_type_code": "AS", "status": "Active", "status_code": "A", "deletion_date": null, "registration_number": "10117826", "registration_date": "1996-11-18", "registered_capital": "25560", "registered_capital_currency": "EUR", "vat_number": "EE100106532", "address": "Endla tn 15, 10122, Tallinn, Harju maakond", "activity": "63.99", "activity_code": "63.99", "activity_description": "Other information service activities n.e.c.", "country": "EST" } ``` {% endtab %} {% tab title="400 Invalid country code" %} ```javascript { "error": "error", "code": 400, "message": "Country code is wrong. Must be EST LTU or LVA" } ``` {% endtab %} {% tab title="401 Invalid token" %} ```javascript { "error": "error", "code": 401, "message": "Token is wrong" } ``` {% endtab %} {% tab title="402 Not enough credit" %} ```javascript { "error": "error", "code": 402, "message": "Monthly requests limit exceeded" } ``` {% endtab %} {% tab title="403 " %} ```javascript { "error": "error", "code": 403, "message": "This request is not allowed for you" } ``` {% endtab %} {% tab title="404 Could not find a company matching this query" %} ```javascript { "error": "error", "code": 404, "message": "No such company" } ``` {% endtab %} {% tab title="409 " %} ```javascript { "error": "error", "code": 409, "message": "Something went wrong" } ``` {% endtab %} {% tab title="422 Validation failed" %} ```javascript { "error": "error", "code": 422, "message": "Schema validation error" } ``` {% endtab %} {% tab title="423 " %} ```javascript { "error": "error", "code": 423, "message": "Locked. Wait for previous request to complete" } ``` {% endtab %} {% tab title="500 " %} ```javascript { "error": "error", "code": 500, "message": "Internal Server Error" } ``` {% endtab %} {% endtabs %} # getContacts TEST request - https\://in.bisnode.ee/rest\_dev/getContacts ## getContacts `POST` `https://in.bisnode.ee/rest/getContacts` **Needed Headers:** Content-type: application/json\ \ This endpoint allows you to get company contacts such as:\ `* Address`\ `* WWW`\ `* E-mail`\ `* Telephone`\ `* FAX`\ \ Example Curl request:\ `curl -X POST -k -H 'Content-type: application/json' -i 'https://in.bisnode.ee/rest/getContacts' --data '{`\ `"token": "0c725874e737c8195de547f67692d8b976726561",`\ `"reg_code": "10117826",`\ `"country": "EST",`\ `"language": "en"`\ `}'` #### Query Parameters | Name | Type | Description | | --------- | ------ | -------------------------------------------------------------------- | | language | string | 2-letter language code. Must be "en", "et" or "ru". Default is "en". | | token | string | Your 'access token' (API key). | | reg\_code | string | Company registration number. | | country | string | 3-letter country code "EST" or "LVA". Default is "EST". | {% tabs %} {% tab title="200 " %} ```javascript [ { "type": "Address", "type_code": "ADDRESS", "content": "Endla tn 15, 10122, Tallinn, Harju maakond, Eesti Vabariik" }, { "type": "Internet address (www)", "type_code": "WWW", "content": "www.bisnode.ee" }, { "type": "E-mail address", "type_code": "EMAIL", "content": "info@bisnode.ee" }, { "type": "Telephone", "type_code": "TEL", "content": "+372 641 4910" }, { "type": "Fax", "type_code": "FAX", "content": "+372 641 4910" } ] ``` {% endtab %} {% tab title="400 Invalid country code" %} ```javascript { "error": "error", "code": 400, "message": "Only EST and LVA countries are supported in this request" } ``` {% endtab %} {% tab title="401 Invalid token" %} ```javascript { "error": "error", "code": 401, "message": "Token is wrong" } ``` {% endtab %} {% tab title="402 Not enough credit" %} ```javascript { "error": "error", "code": 402, "message": "Monthly requests limit exceeded" } ``` {% endtab %} {% tab title="403 " %} ```javascript { "error": "error", "code": 403, "message": "This request is not allowed for you" } ``` {% endtab %} {% tab title="404 Could not find a company matching this query" %} ```javascript { "error": "error", "code": 404, "message": "No such company" } ``` {% endtab %} {% tab title="409 " %} ```javascript { "error": "error", "code": 409, "message": "Something went wrong" } ``` {% endtab %} {% tab title="422 Validation failed" %} ```javascript { "error": "error", "code": 422, "message": "Schema validation error" } ``` {% endtab %} {% tab title="423 " %} ```javascript { "error": "error", "code": 423, "message": "Locked. Wait for previous request to complete" } ``` {% endtab %} {% tab title="500 " %} ```javascript { "error": "error", "code": 500, "message": "Internal Server Er ``` {% endtab %} {% endtabs %} # getAaaRatingWithHistory TEST request - https\://in.bisnode.ee/rest\_dev/getAaaRatingWithHistory ## getAaaRatingWithHistory `POST` `https://in.bisnode.ee/rest/getAaaRatingWithHistory` **Needed Headers:** Content-type: application/json\ \ This endpoint allows you to get company current AAA rating and rating history.\ AAA rating consist of:\ `* Operation rating`\ `* Background rating`\ `* Finance rating`\ `* ATP rating`\ `* AAA rating`\ `* Credit limit`\ \ Example Curl request:\ `curl -X POST -k -H 'Content-type: application/json' -i 'https://in.bisnode.ee/rest/getAaaRatingWithHistory' --data '{`\ `"token": "0c725874e737c8195de547f67692d8b976726561",`\ `"reg_code": "10117826",`\ `"country": "EST",`\ `"language": "en"`\ `}'`
#### Query Parameters | Name | Type | Description | | --------- | ------ | -------------------------------------------------------------------- | | language | string | 2-letter language code. Must be "en", "et" or "ru". Default is "en". | | token | string | Your 'access token' (API key). | | reg\_code | string | Company registration number. | | country | string | 3-letter country code "EST" or "LVA". Default is "EST". | {% tabs %} {% tab title="200 " %} ```javascript { "aaa_rating": { "operation_rating": { "code": "A-EST", "status": "Established", "color": "green", "description": null }, "background_rating": { "code": "D-POSI", "status": "Positive", "color": "green", "description": null }, "finance_rating": { "code": "F-GOOD", "status": "Good", "color": "green", "description": null }, "atp_rating": { "code": "A-NONE", "status": "Not negative", "color": "green", "description": null }, "aaa_rating": { "code": "AA", "status": "Good Creditworthiness", "color": "green", "description": null }, "credit_limit": { "code": 111111.9, "status": "111112 EUR", "color": "green", "description": null } }, "aaa_rating_history": { "id": "1111", "company_id": "1111", "operation_rating": "A-EST", "background_rating": "D-POSI", "finance_rating": "F-GOOD", "atp_rating": "A-NONE", "aaa_rating": "AA", "credit_limit": "111111", "end_date": null, "log": "log", "created_at": "2017-10-02 22:07:48", "updated_at": "2018-01-18 15:11:06" } } ``` {% endtab %} {% tab title="400 Invalid country code" %} ```javascript { "error": "error", "code": 400, "message": "Only EST and LVA countries are supported in this request" } ``` {% endtab %} {% tab title="401 Invalid token" %} ```javascript { "error": "error", "code": 401, "message": "Token is wrong" } ``` {% endtab %} {% tab title="402 Not enough credit" %} ```javascript { "error": "error", "code": 402, "message": "Monthly requests limit exceeded" } ``` {% endtab %} {% tab title="403 " %} ```javascript { "error": "error", "code": 403, "message": "This request is not allowed for you" } ``` {% endtab %} {% tab title="404 Could not find a company matching this query" %} ```javascript { "error": "error", "code": 404, "message": "No such company" } ``` {% endtab %} {% tab title="409 " %} ```javascript { "error": "error", "code": 409, "message": "Something went wrong" } ``` {% endtab %} {% tab title="422 Validation failed" %} ```javascript { "error": "error", "code": 422, "message": "Schema validation error" } ``` {% endtab %} {% tab title="423 " %} ```javascript { "error": "error", "code": 423, "message": "Locked. Wait for previous request to complete" } ``` {% endtab %} {% tab title="500 " %} ```javascript { "error": "error", "code": 500, "message": "Internal Server Error" } ``` {% endtab %} {% endtabs %} # getCompanyUpdateDate TEST request - https\://in.bisnode.ee/rest\_dev/getCompanyUpdateDate ## getCompanyUpdateDate `POST` `https://in.bisnode.ee/rest/getCompanyUpdateDate` **Needed Headers:** Content-type: application/json\ \ This endpoint allows you to get general company information such as: \ `* Latest update date of given company`\ \ Example Curl request:\ `curl -X POST -k -H 'Content-type: application/json' -i 'https://in.bisnode.ee/rest/getCompanyUpdateDate' --data '{`\ `"token": "0c725874e737c8195de547f67692d8b976726561",`\ `"reg_code": "10117826",`\ `"country": "EST",`\ `"language": "en"`\ `}'` #### Query Parameters | Name | Type | Description | | --------- | ------ | -------------------------------------------------------------------- | | language | string | 2-letter language code. Must be "en", "et" or "ru". Default is "en". | | token | string | Your 'access token' (API key). | | reg\_code | string | Company registration number. | | country | string | 3-letter country code "EST", "LVA" or "LTU". Default is "EST". | {% tabs %} {% tab title="200 Response successfully retrieved" %} ```javascript { "date": "2020-01-01" } ``` {% endtab %} {% tab title="400 Invalid country code" %} ```javascript { "error": "error", "code": 400, "message": "Country code is wrong. Must be EST LTU or LVA" } ``` {% endtab %} {% tab title="401 Invalid token" %} ```javascript { "error": "error", "code": 401, "message": "Token is wrong" } ``` {% endtab %} {% tab title="402 Not enough credit" %} ```javascript { "error": "error", "code": 402, "message": "Monthly requests limit exceeded" } ``` {% endtab %} {% tab title="403 " %} ```javascript { "error": "error", "code": 403, "message": "This request is not allowed for you" } ``` {% endtab %} {% tab title="404 Could not find a company matching this query" %} ```javascript { "error": "error", "code": 404, "message": "No such company" } ``` {% endtab %} {% tab title="409 " %} ```javascript { "error": "error", "code": 409, "message": "Something went wrong" } ``` {% endtab %} {% tab title="422 Validation failed" %} ```javascript { "error": "error", "code": 422, "message": "Schema validation error" } ``` {% endtab %} {% tab title="423 " %} ```javascript { "error": "error", "code": 423, "message": "Locked. Wait for previous request to complete" } ``` {% endtab %} {% tab title="500 " %} ```javascript { "error": "error", "code": 500, "message": "Internal Server Error" } ``` {% endtab %} {% endtabs %} # getTaxArrears TEST request - https\://in.bisnode.ee/rest\_dev/getTaxArrears ## getTaxArrears `POST` `https://in.bisnode.ee/rest/getTaxArrears` **Needed Headers:** Content-type: application/json\ \ This endpoint allows you to get company tax arrears for two last years such as:\ `* Current tax arrears`\ `* Tax arrears history`\ \ Example Curl request:\ `curl -X POST -k -H 'Content-type: application/json' -i 'https://in.bisnode.ee/rest/getTaxArrears' --data '{`\ `"token": "0c725874e737c8195de547f67692d8b976726561",`\ `"reg_code": "10117826",`\ `"country": "EST",`\ `"language": "en"`\ `}'` #### Query Parameters | Name | Type | Description | | --------- | ------ | -------------------------------------------------------------------- | | language | string | 2-letter language code. Must be "en", "et" or "ru". Default is "en". | | token | string | Your 'access token' (API key). | | reg\_code | string | Company registration number. | | country | string | 3-letter country code "EST". Default is "EST". | {% tabs %} {% tab title="200 " %} ```javascript { "tax_arrears_current": [ { "amount": "1111.83", "scheduled": "1111.83", "disputed": true, "intress": "0.00", "total": 1111.83, "from": "2015-05-20", "num_of_declarations": null } ], "tax_arrears_history": [ { "label": "Jun 2019", "year": "2019", "month": "6", "amount": 11111, "scheduled": 11111, "disputed": 0, "intress": 0, "total": 11111, "from": "2015-05-20", "num_of_declarations": 0, "num_of_cases": 1 }, { "label": "May 2019", "year": "2019", "month": "5", "amount": 2222, "scheduled": 2222, "disputed": 0, "intress": 0, "total": 2222, "from": "2015-05-20", "num_of_declarations": 0, "num_of_cases": 1 } ] } ``` {% endtab %} {% tab title="400 Invalid country code" %} ```javascript { "error": "error", "code": 400, "message": "Only EST country supported in this request" } ``` {% endtab %} {% tab title="401 Invalid token" %} ```javascript { "error": "error", "code": 401, "message": "Token is wrong" } ``` {% endtab %} {% tab title="402 Not enough credit" %} ```javascript { "error": "error", "code": 402, "message": "Monthly requests limit exceeded" } ``` {% endtab %} {% tab title="403 " %} ```javascript { "error": "error", "code": 403, "message": "This request is not allowed for you" } ``` {% endtab %} {% tab title="404 Could not find a company matching this query" %} ```javascript { "error": "error", "code": 404, "message": "No such company" } ``` {% endtab %} {% tab title="409 " %} ```javascript { "error": "error", "code": 409, "message": "Something went wrong" } ``` {% endtab %} {% tab title="422 Validation failed" %} ```javascript { "error": "error", "code": 422, "message": "Schema validation error" } ``` {% endtab %} {% tab title="423 " %} ```javascript { "error": "error", "code": 423, "message": "Locked. Wait for previous request to complete" } ``` {% endtab %} {% tab title="500 " %} ```javascript { "error": "error", "code": 500, "message": "Internal Server Error" } ``` {% endtab %} {% endtabs %} # getPublicAnnouncements TEST request - https\://in.bisnode.ee/rest\_dev/getPublicAnnouncements ## getPublicAnnouncements `POST` `https://in.bisnode.ee/rest/getPublicAnnouncements` **Needed Headers:** Content-type: application/json\ \ This endpoint allows you to get company debts for two last years such as:\ `* Enforcement notices`\ `* Court decisions on debts`\ \ Example Curl request:\ `curl -X POST -k -H 'Content-type: application/json' -i 'https://in.bisnode.ee/rest/getPublicAnnouncements' --data '{`\ `"token": "0c725874e737c8195de547f67692d8b976726561",`\ `"reg_code": "10117826",`\ `"country": "EST",`\ `"language": "en"`\ `}'` #### Query Parameters | Name | Type | Description | | --------- | ------ | ------------------------------------------------------------------- | | language | string | 2-letter language code. Must be "en", "et" or "ru. Default is "en". | | token | string | Your 'access token' (API key). | | reg\_code | string | Company registration number. | | country | string | 3-letter country code "EST". Default is "EST". | {% tabs %} {% tab title="200 " %} ```javascript { "enforcement_notices": [ { "id": "111111", "ata_id": "111111", "debtor_name": "ABC OU", "debtor_code": "11111111", "birth_date": null, "claim_amount": "66.10", "amount": "138.10", "post_amount": "164.50", "deadline_date": "2019-01-01", "claimant_type": null, "claimant_code": null, "claimant_area": "MUUD", "debtor_type": "J", "message_type": "T\u00e4itmisteade", "action_type": null, "created_at": "2019-06-18", "checked_at": "2019-06-19", "claimant_type_txt": "Unspecified" } ], "court_decisions_on_debt": [ { "id": "111111", "ata_id": "1111111", "debtor_name": "ABC OU", "debtor_code": "11111111", "birth_date": null, "claim_amount": "1111.14", "amount": "2222.47", "post_amount": null, "deadline_date": null, "claimant_type": null, "claimant_code": null, "claimant_area": "MUUD", "debtor_type": "J", "message_type": "Kohtu maksek\u00e4suosakonna m\u00e4\u00e4ruse k\u00e4ttetoimetamise teade", "action_type": "Makseettepanek", "created_at": "2019-06-17", "checked_at": "2019-06-19", "action_type_txt": "Payment proposal", "claimant_type_txt": "Unspecified" } ] } ``` {% endtab %} {% tab title="400 Invalid country code" %} ```javascript { "error": "error", "code": 400, "message": "Only EST country supported in this request" } ``` {% endtab %} {% tab title="401 Invalid token" %} ```javascript { "error": "error", "code": 401, "message": "Token is wrong" } ``` {% endtab %} {% tab title="402 Not enough credit" %} ```javascript { "error": "error", "code": 402, "message": "Monthly requests limit exceeded" } ``` {% endtab %} {% tab title="403 " %} ```javascript { "error": "error", "code": 403, "message": "This request is not allowed for you" } ``` {% endtab %} {% tab title="404 Could not find a company matching this query" %} ```javascript { "error": "error", "code": 404, "message": "No such company" } ``` {% endtab %} {% tab title="409 " %} ```javascript { "error": "error", "code": 409, "message": "Something went wrong" } ``` {% endtab %} {% tab title="422 Validation failed" %} ```javascript { "error": "error", "code": 422, "message": "Schema validation error" } ``` {% endtab %} {% tab title="423 " %} ```javascript { "error": "error", "code": 423, "message": "Locked. Wait for previous request to complete" } ``` {% endtab %} {% tab title="500 " %} ```javascript { "error": "error", "code": 500, "message": "Internal Server Error" } ``` {% endtab %} {% endtabs %} # getDebtCollectionCases TEST request - https\://in.bisnode.ee/rest\_dev/getDebtCollectionCases ## getDebtCollectionCases `POST` `https://in.bisnode.ee/rest/getDebtCollectionCases` **Needed Headers:** Content-type: application/json\ \ This endpoint allows you to get company debt collection cases for two last years. \ \ Example Curl request:\ `curl -X POST -k -H 'Content-type: application/json' -i 'https://in.bisnode.ee/rest/getDebtCollectionCases' --data '{`\ `"token": "0c725874e737c8195de547f67692d8b976726561",`\ `"reg_code": "10117826",`\ `"country": "EST",`\ `"language": "en"`\ `}'` #### Query Parameters | Name | Type | Description | | --------- | ------ | -------------------------------------------------------------------- | | language | string | 2-letter language code. Must be "en", "et" or "ru". Default is "en". | | token | string | Your 'access token' (API key). | | reg\_code | string | Company registration number. | | country | string | 3-letter country code "EST". Default is "EST". | {% tabs %} {% tab title="200 " %} ```javascript [ { "id": "1111", "source_id": "1", "company_id": "11111", "claimant": "Lowell", "reg_code": "11111111", "start_date": "2015-01-01", "end_date": "2019-07-20", "area": null, "amount": null, "status": "Resolved", "last_seen": "2019-07-27", "created_at": null, "updated_at": null, "area_code": null, "active": false, "status_code": "\u041a" }, { "id": "1112", "company_id": "11111", "reg_code": "11111111", "end_date": null, "amount": "114.10", "source_id": null, "claimant": "Krediidiregister", "area": null, "area_code": null, "active": true, "status": "Active", "status_code": "A", "start_date": "2017-02-26", "last_seen": "2019-08-01" } ] ``` {% endtab %} {% tab title="400 Invalid country code" %} ```javascript { "error": "error", "code": 400, "message": "Only EST and LVA countries are supported in this request" } ``` {% endtab %} {% tab title="401 Invalid token" %} ```javascript { "error": "error", "code": 401, "message": "Token is wrong" } ``` {% endtab %} {% tab title="402 Not enough credit" %} ```javascript { "error": "error", "code": 402, "message": "Monthly requests limit exceeded" } ``` {% endtab %} {% tab title="403 " %} ```javascript { "error": "error", "code": 403, "message": "This request is not allowed for you" } ``` {% endtab %} {% tab title="404 Could not find a company matching this query" %} ```javascript { "error": "error", "code": 404, "message": "No such company" } ``` {% endtab %} {% tab title="409 " %} ```javascript { "error": "error", "code": 409, "message": "Something went wrong" } ``` {% endtab %} {% tab title="422 Validation failed" %} ```javascript { "error": "error", "code": 422, "message": "Schema validation error" } ``` {% endtab %} {% tab title="423 " %} ```javascript { "error": "error", "code": 423, "message": "Locked. Wait for previous request to complete" } ``` {% endtab %} {% tab title="500 " %} ```javascript { "error": "error", "code": 500, "message": "Internal Server Error" } ``` {% endtab %} {% endtabs %} # getManagementBoard TEST request - https\://in.bisnode.ee/rest\_dev/getManagementBoard ## getManagementBoard `POST` `https://in.bisnode.ee/rest/getManagementBoard` **Needed Headers:** Content-type: application/json\ \ This endpoint allows you to get information about current and previous members of management board, company representation rights.\ \ Example Curl request:\ `curl -X POST -k -H 'Content-type: application/json' -i 'https://in.bisnode.ee/rest/getManagementBoard' --data '{`\ `"token": "0c725874e737c8195de547f67692d8b976726561",`\ `"reg_code": "10117826",`\ `"country": "EST",`\ `"language": "en"`\ `}'` #### Query Parameters | Name | Type | Description | | --------- | ------ | -------------------------------------------------------------------- | | language | string | 2-letter language code. Must be "en", "et" or "ru". Default is "en". | | token | string | Your 'access token' (API key). | | reg\_code | string | Company registration number. | | country | string | 3-letter country code "EST" or "LVA". Default is "EST". | {% tabs %} {% tab title="200 " %} ```javascript [ { "role": "Management board member", "role_code": "JUHL", "start_date": "2019-05-14", "end_date": null, "created_at": "2019-05-15 13:15:46", "updated_at": "2019-05-23 13:14:40", "active": "active", "on_card": true, "code": "11111111111", "person_birth_date": "1955-05-11", "person_gener": "M", "country": "EST", "name": "Karl Karll", "type": "Physical person" }, { "role": "Management board member", "role_code": "JUHL", "start_date": "2007-07-27", "end_date": "2010-07-07", "created_at": "2018-01-12 17:12:33", "updated_at": "2018-01-12 17:12:33", "active": "inactive", "on_card": true, "code": "11111111111", "person_birth_date": "1966-06-16", "person_gener": "M", "country": "EST", "name": "Ants Antss", "type": "Physical person" } ] ``` {% endtab %} {% tab title="400 Invalid country code" %} ```javascript { "error": "error", "code": 400, "message": "Only EST and LVA countries are supported in this request" } ``` {% endtab %} {% tab title="401 Invalid token" %} ```javascript { "error": "error", "code": 401, "message": "Token is wrong" } ``` {% endtab %} {% tab title="402 Not enough credit" %} ```javascript { "error": "error", "code": 402, "message": "Monthly requests limit exceeded" } ``` {% endtab %} {% tab title="403 " %} ```javascript { "error": "error", "code": 403, "message": "This request is not allowed for you" } ``` {% endtab %} {% tab title="404 Could not find a company matching this query" %} ```javascript { "error": "error", "code": 404, "message": "No such company" } ``` {% endtab %} {% tab title="409 " %} ```javascript { "error": "error", "code": 409, "message": "Something went wrong" } ``` {% endtab %} {% tab title="422 Validation failed" %} ```javascript { "error": "error", "code": 422, "message": "Schema validation error" } ``` {% endtab %} {% tab title="423 " %} ```javascript { "error": "error", "code": 423, "message": "Locked. Wait for previous request to complete" } ``` {% endtab %} {% tab title="500 " %} ```javascript { "error": "error", "code": 500, "message": "Internal Server Error" } ``` {% endtab %} {% endtabs %} # getShareholdersAndOtherRoles TEST request - https\://in.bisnode.ee/rest\_dev/getShareholdersAndOtherRoles ## getShareholdersAndOtherRoles `POST` `https://in.bisnode.ee/rest/getShareholdersAndOtherRoles` **Needed Headers:** Content-type: application/json\ \ This endpoint allows you to get company current and previous owners, shareholders and other connected persons, such as members of supervisory board, auditors.\ \ Example Curl request:\ `curl -X POST -k -H 'Content-type: application/json' -i 'https://in.bisnode.ee/rest/getShareholdersAndOtherRoles' --data '{`\ `"language": "en",`\ `"token": "0c725874e737c8195de547f67692d8b976726561",`\ `"reg_code": "10117826",`\ `"country": "EST",`\ `"language": "en"`\ `}'` #### Query Parameters | Name | Type | Description | | --------- | ------ | -------------------------------------------------------------------- | | language | string | 2-letter language code. Must be "en", "et" or "ru". Default is "en". | | token | string | Your 'access token' (API key). | | reg\_code | string | Company registration number. | | country | string | 3-letter country code "EST" or "LVA". Default is "EST". | {% tabs %} {% tab title="200 " %} ```javascript [ { "role": "Stockholder", "role_code": "S", "information_source": "NASDAQ andmed", "authority_end_date": null, "start_date": "2011-11-11", "end_date": null, "revision_date": null, "control_source": null, "control_source_code": null, "control_source_date": null, "group": null, "created_at": "2018-09-13 17:05:17", "updated_at": "2018-09-13 17:05:17", "active": "active", "on_card": false, "code": "11111111", "person_birth_date": null, "person_gener": null, "country": "EST", "name": "Aktsiaselts ABC", "type": "Juridical person", "type_code": "J", "ownership": "Simple ownership", "ownership_code": "L", "share_capital_amount": "1111111.11", "share_capital_currency": "EUR", "share_capital_percent": "100.00", "trade_ban": null, "tags": [] }, { "role": "Chairman of the supervisory board", "role_code": "E", "information_source": null, "authority_end_date": null, "start_date": "2011-11-11", "end_date": null, "revision_date": null, "control_source": "Electronically submitted (entry) statement", "control_source_code": null, "control_source_date": null, "group": null, "created_at": "2018-09-13 17:05:17", "updated_at": "2018-09-13 17:05:17", "active": "active", "on_card": false, "code": "11111111111", "person_birth_date": "1955-11-11", "person_gener": "M", "country": "EST", "name": "Karl Karll", "type": "Physical person", "type_code": "F", "ownership": null, "ownership_code": null, "share_capital_amount": null, "share_capital_currency": null, "share_capital_percent": null, "trade_ban": null, "tags": [] } ] ``` {% endtab %} {% tab title="400 Invalid country code" %} ```javascript { "error": "error", "code": 400, "message": "Only EST and LVA countries are supported in this request" } ``` {% endtab %} {% tab title="401 Invalid token" %} ```javascript { "error": "error", "code": 401, "message": "Token is wrong" } ``` {% endtab %} {% tab title="402 Not enough credit" %} ```javascript { "error": "error", "code": 402, "message": "Monthly requests limit exceeded" } ``` {% endtab %} {% tab title="403 " %} ```javascript { "error": "error", "code": 403, "message": "This request is not allowed for you" } ``` {% endtab %} {% tab title="404 Could not find a company matching this query" %} ```javascript { "error": "error", "code": 404, "message": "No such company" } ``` {% endtab %} {% tab title="409 " %} ```javascript { "error": "error", "code": 409, "message": "Something went wrong" } ``` {% endtab %} {% tab title="422 Validation failed" %} ```javascript { "error": "error", "code": 422, "message": "Schema validation error" } ``` {% endtab %} {% tab title="423 " %} ```javascript { "error": "error", "code": 423, "message": "Locked. Wait for previous request to complete" } ``` {% endtab %} {% tab title="500 " %} ```javascript { "error": "error", "code": 500, "message": "Internal Server Error" } ``` {% endtab %} {% endtabs %} # getBeneficialOwner TEST request - https\://in.bisnode.ee/rest\_dev/getBeneficialOwner ## getBeneficialOwner `POST` `https://in.bisnode.ee/rest/getBeneficialOwner` **Needed Headers:** Content-type: application/json\ \ This endpoint allows you to get company beneficial owners.\ Beneficial owner is currently determined using Bisnode’s Estonian company database. Foreign beneficial owners may not be found.\ \ Example Curl request:\ `curl -X POST -k -H 'Content-type: application/json' -i 'https://in.bisnode.ee/rest/getBeneficialOwner' --data '{`\ `"token": "0c725874e737c8195de547f67692d8b976726561",`\ `"reg_code": "10117826",`\ `"country": "EST",`\ `"language": "en"`\ `}'` #### Query Parameters | Name | Type | Description | | --------- | ------ | -------------------------------------------------------------------- | | language | string | 2-letter language code. Must be "en", "et" or "ru". Default is "en". | | token | string | Your 'access token' (API key). | | reg\_code | string | Company registration number. | | country | string | 3-letter country code "EST" or "LVA". Default is "EST". | {% tabs %} {% tab title="200 " %} ```javascript { "reg_code": "11111111", "business_name": "ABC invest", "beneficial_owners": [ { "id": "11111", "full_name": "Karl Karll", "full_name_normalized": "Karl Karll", "code": "11111111111", "person_gender": "M", "birth_date": "1960-12-12", "code_origin": "EST", "type": "person", "address": null, "created_at": "2014-05-09 00:00:00", "updated_at": "2018-01-22 12:09:00", "beneficial_owner_type": "direct" }, { "id": "11112", "full_name": "Aivar Aivo", "full_name_normalized": "Aivar Aivo", "code": "22222222222", "person_gender": "M", "birth_date": "1970-08-08", "code_origin": "EST", "type": "person", "address": "Tartu linn, Tartu maakond, Eesti Vabariik", "created_at": "2014-09-09 00:00:00", "updated_at": "2019-01-25 11:16:05", "beneficial_owner_type": "indirect" } ] } ``` {% endtab %} {% tab title="400 Invalid country code" %} ```javascript { "error": "error", "code": 400, "message": "Only EST and LVA countries are supported in this request" } ``` {% endtab %} {% tab title="401 Invalid token" %} ```javascript { "error": "error", "code": 401, "message": "Token is wrong" } ``` {% endtab %} {% tab title="402 Not enough credit" %} ```javascript { "error": "error", "code": 402, "message": "Monthly requests limit exceeded" } ``` {% endtab %} {% tab title="403 " %} ```javascript { "error": "error", "code": 403, "message": "This request is not allowed for you" } ``` {% endtab %} {% tab title="404 Could not find a company matching this query" %} ```javascript { "error": "error", "code": 404, "message": "No such company" } ``` {% endtab %} {% tab title="409 " %} ```javascript { "error": "error", "code": 409, "message": "Something went wrong" } ``` {% endtab %} {% tab title="422 Validation failed" %} ```javascript { "error": "error", "code": 422, "message": "Schema validation error" } ``` {% endtab %} {% tab title="423 " %} ```javascript { "error": "error", "code": 423, "message": "Locked. Wait for previous request to complete" } ``` {% endtab %} {% tab title="500 " %} ```javascript { "error": "error", "code": 500, "message": "Internal Server Error" } ``` {% endtab %} {% endtabs %} # listAnnualReport TEST request - https\://in.bisnode.ee/rest\_dev/listAnnualReport ## listAnnualReport `POST` `https://in.bisnode.ee/rest/listAnnualReport` Returns list of available annual report documents (PDF, XBRL, BDOC) from Äriregister.\ \ Example Curl request:\ `curl -X POST -k -H 'Content-type: application/json' -i 'https://in.bisnode.ee/rest/listAnnualReport' --data '{` \ `"token": "0c725874e737c8195de547f67692d8b976726561",` \ `"reg_code": "10117826",` \ `"country": "EST"` \ `}'` #### Query Parameters | Name | Type | Description | | --------- | ------ | --------------------------------------- | | token | string | Your access token (api key) | | reg\_code | string | Country registration number | | country | string | 3-letter country code. Default is "EST" | {% tabs %} {% tab title="200 " %} ``` [ { "country": "EST", "reg_code": "10117826", "doc_type": "A", "annual_year": "2001", "description": "PDF document", "created_at": "2002-07-08" }, { "country": "EST", "reg_code": 10117826, "doc_type": "A", "annual_year": 2003, "description": "PDF document", "created_at": "2004-07-12" }, { "country": "EST", "reg_code": "10117826", "doc_type": "A", "annual_year": "2008", "description": "PDF document", "created_at": "2009-06-26" }, { "country": "EST", "reg_code": "10117826", "doc_type": "A", "annual_year": "2011", "description": "PDF document", "created_at": "2012-06-26" }, { "country": "EST", "reg_code": 10117826, "doc_type": "X", "annual_year": 2011, "description": "XBRL document", "created_at": "2012-06-26" }, { "country": "EST", "reg_code": "10117826", "doc_type": "A", "annual_year": "2000", "description": "PDF document", "created_at": "2001-05-28" }, { "country": "EST", "reg_code": 10117826, "doc_type": "A", "annual_year": 2002, "description": "PDF document", "created_at": "2003-07-03" }, { "country": "EST", "reg_code": 10117826, "doc_type": "A", "annual_year": 2004, "description": "PDF document", "created_at": "2005-07-01" }, { "country": "EST", "reg_code": "10117826", "doc_type": "A", "annual_year": "2005", "description": "PDF document", "created_at": "2006-07-03" }, { "country": "EST", "reg_code": "10117826", "doc_type": "A", "annual_year": "2007", "description": "PDF document", "created_at": "2008-04-29" }, { "country": "EST", "reg_code": "10117826", "doc_type": "A", "annual_year": "2006", "description": "PDF document", "created_at": "2007-06-28" }, { "country": "EST", "reg_code": "10117826", "doc_type": "A", "annual_year": "2009", "description": "PDF document", "created_at": "2010-06-02" }, { "country": "EST", "reg_code": 10117826, "doc_type": "X", "annual_year": 2009, "description": "XBRL document", "created_at": "2010-06-02" }, { "country": "EST", "reg_code": "10117826", "doc_type": "A", "annual_year": "2010", "description": "PDF document", "created_at": "2011-06-20" }, { "country": "EST", "reg_code": 10117826, "doc_type": "X", "annual_year": 2010, "description": "XBRL document", "created_at": "2011-06-20" }, { "country": "EST", "reg_code": "10117826", "doc_type": "A", "annual_year": "2012", "description": "PDF document", "created_at": "2013-06-19" }, { "country": "EST", "reg_code": 10117826, "doc_type": "D", "annual_year": 2012, "description": "DDOC\/BDOC container", "created_at": "2013-06-19" }, { "country": "EST", "reg_code": "10117826", "doc_type": "X", "annual_year": "2012", "description": "XBRL document", "created_at": "2013-06-19" }, { "country": "EST", "reg_code": "10117826", "doc_type": "A", "annual_year": "2013", "description": "PDF document", "created_at": "2014-06-18" }, { "country": "EST", "reg_code": "10117826", "doc_type": "X", "annual_year": "2013", "description": "XBRL document", "created_at": "2014-06-18" }, { "country": "EST", "reg_code": "10117826", "doc_type": "A", "annual_year": "2014", "description": "PDF document", "created_at": "2015-06-15" }, { "country": "EST", "reg_code": "10117826", "doc_type": "X", "annual_year": "2014", "description": "XBRL document", "created_at": "2015-06-15" }, { "country": "EST", "reg_code": "10117826", "doc_type": "A", "annual_year": "2015", "description": "PDF document", "created_at": "2016-04-06" }, { "country": "EST", "reg_code": 10117826, "doc_type": "D", "annual_year": 2015, "description": "DDOC\/BDOC container", "created_at": "2016-04-06" }, { "country": "EST", "reg_code": "10117826", "doc_type": "X", "annual_year": "2015", "description": "XBRL document", "created_at": "2016-04-06" }, { "country": "EST", "reg_code": "10117826", "doc_type": "A", "annual_year": "2016", "description": "PDF document", "created_at": "2017-06-26" }, { "country": "EST", "reg_code": 10117826, "doc_type": "D", "annual_year": 2016, "description": "DDOC\/BDOC container", "created_at": "2017-06-26" }, { "country": "EST", "reg_code": "10117826", "doc_type": "X", "annual_year": "2016", "description": "XBRL document", "created_at": "2017-06-26" }, { "country": "EST", "reg_code": "10117826", "doc_type": "A", "annual_year": "2017", "description": "PDF document", "created_at": "2018-07-11" }, { "country": "EST", "reg_code": 10117826, "doc_type": "D", "annual_year": 2017, "description": "DDOC\/BDOC container", "created_at": "2018-07-11" }, { "country": "EST", "reg_code": "10117826", "doc_type": "X", "annual_year": "2017", "description": "XBRL document", "created_at": "2018-07-11" }, { "country": "EST", "reg_code": "10117826", "doc_type": "A", "annual_year": "2018", "description": "PDF document", "created_at": "2019-06-21" }, { "country": "EST", "reg_code": 10117826, "doc_type": "D", "annual_year": 2018, "description": "DDOC\/BDOC container", "created_at": "2019-06-21" }, { "country": "EST", "reg_code": "10117826", "doc_type": "X", "annual_year": "2018", "description": "XBRL document", "created_at": "2019-06-21" } ] ``` {% endtab %} {% endtabs %} # getAnnualReport TEST request - https\://in.bisnode.ee/rest\_dev/getAnnualReport ## getAnnualReport `POST` `https://in.bisnode.ee/rest/getAnnualReport` **Needed Headers:** Content-type: application/json\ \ Using this request you can get annual reports in 3 formats:\ **PDF** (doc\_type **A**)\ **XBRL** (doc\_type **X**)\ **DigiDoc** (doc\_type **D**)\ \ Type **A** includes original **PDF** document and also parsed data like:\ `* General Information`\ `* Balance sheet`\ `* Income Statement`\ `* Cash flows`\ `* Salary expense`\ `* Net sales by activity`\ \ Example Curl request:\ `curl -X POST -k -H 'Content-type: application/json' -i 'https://in.bisnode.ee/rest/getAnnualReport' --data '{`\ `"token": "0c725874e737c8195de547f67692d8b976726561",`\ `"reg_code": "10117826",`\ `"doc_type": "A",`\ `"country": "EST",`\ `"language": "en",`\ `"annual_year": "2018"`\ `}'` #### Query Parameters | Name | Type | Description | | ------------ | ------ | ----------------------------------------------------------------------------------- | | annual\_year | string | Year of annual report. | | language | string | 2-letter language code. Must be "en", "et" or "ru". Default is "en". | | token | string | Your 'access token' (API key). | | reg\_code | string | Company registration number. | | doc\_type | string | Type of annual report. Must be "A"(PDF), "X"(xbrl) or "D"(DigiDoc). Default is "A". | | country | string | 3-letter country code "EST". Default is "EST". | {% tabs %} {% tab title="200 This is full Bisnode annual report of 2018 year" %} ```javascript { "action": "getAnnualReport", "general": { "company_id": "264421", "company_name": "BISNODE ESTONIA AS", "company_type": "Public limited company", "company_type_code": "AS", "status": "Active", "status_code": "A", "deletion_date": null, "registration_number": "10117826", "registration_date": "1996-11-18", "registered_capital": "25560", "registered_capital_currency": "EUR", "vat_number": "EE100106532", "address": "Pronksi tn 12, 10117, Tallinn, Harju maakond", "activity": "63.99", "activity_code": "63.99", "activity_description": "Other information service activities n.e.c.", "country": "EST" }, "attachment": "https:\/\/in.bisnode.ee\/util\/ariregdoc\/198038\/6d36fe0127e4ee83deab58be8b2e0dc4\/10117826_9006199467_A_2018.pdf", "annual_year": "2018", "analysis": [ { "chapter_code": "T001A", "chapter": "Statement of financial position (in the order of growing liquidity)", "code": "StatementOfFinancialPositionAbstract", "date": "2018-12-31;2018-01-01", "value": ";", "name": "Statement of financial position", "bold": "no", "depth": 0 }, { "chapter_code": "T001A", "chapter": "Statement of financial position (in the order of growing liquidity)", "code": "AssetsAbstract", "date": "2018-12-31;2018-01-01", "value": ";", "name": "Assets", "bold": "no", "depth": 0 }, { "chapter_code": "T001A", "chapter": "Statement of financial position (in the order of growing liquidity)", "code": "NonCurrentAssetsAbstract", "date": "2018-12-31;2018-01-01", "value": ";", "name": "Non-current assets", "bold": "no", "depth": 0 }, { "chapter_code": "T001A", "chapter": "Statement of financial position (in the order of growing liquidity)", "code": "IntangibleAssets", "date": "2018-12-31;2018-01-01", "value": "85442;101845", "name": "Intangible assests", "bold": "no", "depth": 0 }, { "chapter_code": "T001A", "chapter": "Statement of financial position (in the order of growing liquidity)", "code": "PropertyPlantAndEquipment", "date": "2018-12-31;2018-01-01", "value": "94076;85904", "name": "Property, plant and equipment", "bold": "no", "depth": 0 }, { "chapter_code": "T001A", "chapter": "Statement of financial position (in the order of growing liquidity)", "code": "LongTermReceivablesAndPrepayments", "date": "2018-12-31;2018-01-01", "value": "14792;14792", "name": "Long term receivables and prepayments", "bold": "no", "depth": 0 }, { "chapter_code": "T001A", "chapter": "Statement of financial position (in the order of growing liquidity)", "code": "NonCurrentAssets", "date": "2018-12-31;2018-01-01", "value": "194310;202541", "name": "Total non-current assets", "bold": "no", "depth": 0 }, { "chapter_code": "T001A", "chapter": "Statement of financial position (in the order of growing liquidity)", "code": "CurrentAssetsAbstract", "date": "2018-12-31;2018-01-01", "value": ";", "name": "Current assets", "bold": "no", "depth": 0 }, { "chapter_code": "T001A", "chapter": "Statement of financial position (in the order of growing liquidity)", "code": "ShortTermReceivablesAndPrepayments", "date": "2018-12-31;2018-01-01", "value": "187060;249252", "name": "Short term receivables and prepayments", "bold": "no", "depth": 0 }, { "chapter_code": "T001A", "chapter": "Statement of financial position (in the order of growing liquidity)", "code": "CashAndCashEquivalents", "date": "2018-12-31;2018-01-01", "value": "1319036;1274359", "name": "Cash and cash equivalents", "bold": "no", "depth": 0 }, { "chapter_code": "T001A", "chapter": "Statement of financial position (in the order of growing liquidity)", "code": "CurrentAssets", "date": "2018-12-31;2018-01-01", "value": "1506096;1523611", "name": "Total current assets", "bold": "no", "depth": 0 }, { "chapter_code": "T001A", "chapter": "Statement of financial position (in the order of growing liquidity)", "code": "Assets", "date": "2018-12-31;2018-01-01", "value": "1700406;1726152", "name": "Total assets", "bold": "no", "depth": 0 }, { "chapter_code": "T001A", "chapter": "Statement of financial position (in the order of growing liquidity)", "code": "LiabilitiesAndEquityAbstract", "date": "2018-12-31;2018-01-01", "value": ";", "name": "Liabilities and equity", "bold": "no", "depth": 0 }, { "chapter_code": "T001A", "chapter": "Statement of financial position (in the order of growing liquidity)", "code": "EquityAbstract", "date": "2018-12-31;2018-01-01", "value": ";", "name": "Equity", "bold": "no", "depth": 0 }, { "chapter_code": "T001A", "chapter": "Statement of financial position (in the order of growing liquidity)", "code": "IssuedCapital2", "date": "2018-12-31;2018-01-01", "value": "25560;25560", "name": "Issued capital", "bold": "no", "depth": 0 }, { "chapter_code": "T001A", "chapter": "Statement of financial position (in the order of growing liquidity)", "code": "StatutoryReserveCapital", "date": "2018-12-31;2018-01-01", "value": "2556;2556", "name": "Statutory reserve capital", "bold": "no", "depth": 0 }, { "chapter_code": "T001A", "chapter": "Statement of financial position (in the order of growing liquidity)", "code": "RetainedEarningsLoss", "date": "2018-12-31;2018-01-01", "value": "1367707;1404390", "name": "Retained earnings (loss)", "bold": "no", "depth": 0 }, { "chapter_code": "T001A", "chapter": "Statement of financial position (in the order of growing liquidity)", "code": "AnnualPeriodProfitLoss", "date": "2018-12-31;2018-01-01", "value": "6073;-36683", "name": "Annual period profit (loss)", "bold": "no", "depth": 0 }, { "chapter_code": "T001A", "chapter": "Statement of financial position (in the order of growing liquidity)", "code": "Equity", "date": "2018-12-31;2018-01-01", "value": "1401896;1395823", "name": "Total equity", "bold": "no", "depth": 0 }, { "chapter_code": "T001A", "chapter": "Statement of financial position (in the order of growing liquidity)", "code": "LiabilitiesAbstract", "date": "2018-12-31;2018-01-01", "value": ";", "name": "Liabilities", "bold": "no", "depth": 0 }, { "chapter_code": "T001A", "chapter": "Statement of financial position (in the order of growing liquidity)", "code": "NonCurrentLiabilitiesAbstract", "date": "2018-12-31;2018-01-01", "value": ";", "name": "Non-current liabilities", "bold": "no", "depth": 0 }, { "chapter_code": "T001A", "chapter": "Statement of financial position (in the order of growing liquidity)", "code": "LongTermLoanLiabilities", "date": "2018-12-31;2018-01-01", "value": "12162;0", "name": "Long term loan liablities", "bold": "no", "depth": 0 }, { "chapter_code": "T001A", "chapter": "Statement of financial position (in the order of growing liquidity)", "code": "NonCurrentLiabilities", "date": "2018-12-31;2018-01-01", "value": "12162;0", "name": "Total non-current liabilities", "bold": "no", "depth": 0 }, { "chapter_code": "T001A", "chapter": "Statement of financial position (in the order of growing liquidity)", "code": "CurrentLiabilitiesAbstract", "date": "2018-12-31;2018-01-01", "value": ";", "name": "Current liabilities", "bold": "no", "depth": 0 }, { "chapter_code": "T001A", "chapter": "Statement of financial position (in the order of growing liquidity)", "code": "ShortTermLoanLiabilities", "date": "2018-12-31;2018-01-01", "value": "2403;5638", "name": "Short term loan liablities", "bold": "no", "depth": 0 }, { "chapter_code": "T001A", "chapter": "Statement of financial position (in the order of growing liquidity)", "code": "ShortTermPayablesAndPrepayments", "date": "2018-12-31;2018-01-01", "value": "283945;324691", "name": "Short term payables and prepayments", "bold": "no", "depth": 0 }, { "chapter_code": "T001A", "chapter": "Statement of financial position (in the order of growing liquidity)", "code": "CurrentLiabilities", "date": "2018-12-31;2018-01-01", "value": "286348;330329", "name": "Total current liabilities", "bold": "no", "depth": 0 }, { "chapter_code": "T001A", "chapter": "Statement of financial position (in the order of growing liquidity)", "code": "Liabilities", "date": "2018-12-31;2018-01-01", "value": "298510;330329", "name": "Total liabilities", "bold": "no", "depth": 0 }, { "chapter_code": "T001A", "chapter": "Statement of financial position (in the order of growing liquidity)", "code": "LiabilitiesAndEquity", "date": "2018-12-31;2018-01-01", "value": "1700406;1726152", "name": "Total liabilities and equity", "bold": "no", "depth": 0 }, { "chapter_code": "T002", "chapter": "Income statement", "code": "IncomeStatementAbstract", "date": "2018-12-31;2018-01-01", "value": ";", "name": "Income statement", "bold": "no", "depth": 0 }, { "chapter_code": "T002", "chapter": "Income statement", "code": "Revenue", "date": "2018-12-31;2018-01-01", "value": "1800716;1841065", "name": "Revenue", "bold": "no", "depth": 0 }, { "chapter_code": "T002", "chapter": "Income statement", "code": "OtherIncome", "date": "2018-12-31;2018-01-01", "value": "5426;1380", "name": "Other income", "bold": "no", "depth": 0 }, { "chapter_code": "T002", "chapter": "Income statement", "code": "RawMaterialsAndConsumablesUsed", "date": "2018-12-31;2018-01-01", "value": "-246282;-322999", "name": "Raw materials and consumables used", "bold": "no", "depth": 0 }, { "chapter_code": "T002", "chapter": "Income statement", "code": "OtherOperatingExpense", "date": "2018-12-31;2018-01-01", "value": "-213477;-198969", "name": "Other operating expense", "bold": "no", "depth": 0 }, { "chapter_code": "T002", "chapter": "Income statement", "code": "EmployeeExpense", "date": "2018-12-31;2018-01-01", "value": "-1251423;-1278085", "name": "Employee expense", "bold": "no", "depth": 0 }, { "chapter_code": "T002", "chapter": "Income statement", "code": "DepreciationAndImpairmentLossReversal", "date": "2018-12-31;2018-01-01", "value": "-80723;-71095", "name": "Depreciation and impairment loss (reversal)", "bold": "no", "depth": 0 }, { "chapter_code": "T002", "chapter": "Income statement", "code": "OtherExpense", "date": "2018-12-31;2018-01-01", "value": "-7839;-7270", "name": "Other expense", "bold": "no", "depth": 0 }, { "chapter_code": "T002", "chapter": "Income statement", "code": "TotalProfitLoss", "date": "2018-12-31;2018-01-01", "value": "6398;-35973", "name": "Profit (loss)", "bold": "no", "depth": 0 }, { "chapter_code": "T002", "chapter": "Income statement", "code": "InterestIncome", "date": "2018-12-31;2018-01-01", "value": "52;0", "name": "Interest income", "bold": "no", "depth": 0 }, { "chapter_code": "T002", "chapter": "Income statement", "code": "InterestExpenses", "date": "2018-12-31;2018-01-01", "value": "-377;-710", "name": "Interest expenses", "bold": "no", "depth": 0 }, { "chapter_code": "T002", "chapter": "Income statement", "code": "TotalProfitLossBeforeTax", "date": "2018-12-31;2018-01-01", "value": "6073;-36683", "name": "Profit (loss) before tax", "bold": "no", "depth": 0 }, { "chapter_code": "T002", "chapter": "Income statement", "code": "TotalAnnualPeriodProfitLoss", "date": "2018-12-31;2018-01-01", "value": "6073;-36683", "name": "Annual period profit (loss)", "bold": "no", "depth": 0 }, { "chapter_code": "T004", "chapter": "Statement of cash flows", "code": "StatementOfCashFlowsAbstract", "date": "2018-12-31;2018-01-01", "value": ";", "name": "Statement of cash flows", "bold": "no", "depth": 0 }, { "chapter_code": "T004", "chapter": "Statement of cash flows", "code": "CashFlowsFromOperatingActivitiesAbstract", "date": "2018-12-31;2018-01-01", "value": ";", "name": "Cash flows from operating activities", "bold": "no", "depth": 0 }, { "chapter_code": "T004", "chapter": "Statement of cash flows", "code": "TotalProfitLoss", "date": "2018-12-31;2018-01-01", "value": "6398;-35973", "name": "Profit (loss)", "bold": "no", "depth": 0 }, { "chapter_code": "T004", "chapter": "Statement of cash flows", "code": "AdjustmentsAbstract", "date": "2018-12-31;2018-01-01", "value": ";", "name": "Adjustments", "bold": "no", "depth": 0 }, { "chapter_code": "T004", "chapter": "Statement of cash flows", "code": "DepreciationAndImpairmentLossReversalNeg", "date": "2018-12-31;2018-01-01", "value": "80723;71095", "name": "Depreciation and impairment loss (reversal)", "bold": "no", "depth": 0 }, { "chapter_code": "T004", "chapter": "Statement of cash flows", "code": "ProfitLossFromSaleOfNonCurrentAssets", "date": "2018-12-31;2018-01-01", "value": "-3506;0", "name": "Profit (loss) from sale of non-current assets", "bold": "no", "depth": 0 }, { "chapter_code": "T004", "chapter": "Statement of cash flows", "code": "Adjustments", "date": "2018-12-31;2018-01-01", "value": "77217;71095", "name": "Total adjustments", "bold": "no", "depth": 0 }, { "chapter_code": "T004", "chapter": "Statement of cash flows", "code": "ChangesInReceivablesAndPrepaymentsRelatedToOperatingActivities", "date": "2018-12-31;2018-01-01", "value": "62192;-734", "name": "Changes in receivables and prepayments related to operating activities", "bold": "no", "depth": 0 }, { "chapter_code": "T004", "chapter": "Statement of cash flows", "code": "ChangesInPayablesAndPrepaymentsRelatedToOperatingActivities", "date": "2018-12-31;2018-01-01", "value": "-42578;104405", "name": "Changes in payables and prepayments related to operating activities", "bold": "no", "depth": 0 }, { "chapter_code": "T004", "chapter": "Statement of cash flows", "code": "OperatingActivitiesIntrestPaid", "date": "2018-12-31;2018-01-01", "value": "-377;-436", "name": "Interest paid", "bold": "no", "depth": 0 }, { "chapter_code": "T004", "chapter": "Statement of cash flows", "code": "CashFlowsFromOperatingActivities", "date": "2018-12-31;2018-01-01", "value": "102852;138357", "name": "Total cash flows from operating activities", "bold": "no", "depth": 0 }, { "chapter_code": "T004", "chapter": "Statement of cash flows", "code": "CashFlowsFromInvestingActivitiesAbstract", "date": "2018-12-31;2018-01-01", "value": ";", "name": "Cash flows from investing activities", "bold": "no", "depth": 0 }, { "chapter_code": "T004", "chapter": "Statement of cash flows", "code": "InvestingActivitiesPurchaseOfPropertyPlantAndEquipmentAndIntangibleAssets", "date": "2018-12-31;2018-01-01", "value": "-56069;-124720", "name": "Purchase of property, plant and equipment and intangible assets", "bold": "no", "depth": 0 }, { "chapter_code": "T004", "chapter": "Statement of cash flows", "code": "InvestingActivitiesIntrestReceived", "date": "2018-12-31;2018-01-01", "value": "52;109", "name": "Interest received", "bold": "no", "depth": 0 }, { "chapter_code": "T004", "chapter": "Statement of cash flows", "code": "CashFlowsFromInvestingActivities", "date": "2018-12-31;2018-01-01", "value": "-56017;-124611", "name": "Total cash flows from investing activities", "bold": "no", "depth": 0 }, { "chapter_code": "T004", "chapter": "Statement of cash flows", "code": "CashFlowsFromFinancingActivitiesAbstract", "date": "2018-12-31;2018-01-01", "value": ";", "name": "Cash flows from financing activities", "bold": "no", "depth": 0 }, { "chapter_code": "T004", "chapter": "Statement of cash flows", "code": "FinancingActivitiesProceedsFromFinanceLease", "date": "2018-12-31;2018-01-01", "value": "-2158;-1863", "name": "Proceeds from finance lease", "bold": "no", "depth": 0 }, { "chapter_code": "T004", "chapter": "Statement of cash flows", "code": "CashFlowsFromFinancingActivities", "date": "2018-12-31;2018-01-01", "value": "-2158;-1863", "name": "Total cash flows from financing activities", "bold": "no", "depth": 0 }, { "chapter_code": "T004", "chapter": "Statement of cash flows", "code": "CashFlows", "date": "2018-12-31;2018-01-01", "value": "44677;11883", "name": "Total cash flows", "bold": "no", "depth": 0 }, { "chapter_code": "T004", "chapter": "Statement of cash flows", "code": "CashAndCashEquivalentsAtBeginningOfPeriod", "date": "2018-12-31;2018-01-01", "value": "1274359;1262476", "name": "Cash and cash equivalents at beginning of period", "bold": "no", "depth": 0 }, { "chapter_code": "T004", "chapter": "Statement of cash flows", "code": "ChangeInCashAndCashEquivalents", "date": "2018-12-31;2018-01-01", "value": "44677;11883", "name": "Change in cash and cash equivalents", "bold": "no", "depth": 0 }, { "chapter_code": "T004", "chapter": "Statement of cash flows", "code": "CashAndCashEquivalentsAtEndOfPeriod", "date": "2018-12-31;2018-01-01", "value": "1319036;1274359", "name": "Cash and cash equivalents at end of period", "bold": "no", "depth": 0 }, { "chapter_code": "T230", "chapter": "Note Miscellaneous operating expenses", "code": "MiscellaneousOperatingExpensesLeases", "date": "2018-12-31;2018-01-01", "value": "-60890;-34647", "name": "Leases", "bold": "no", "depth": 0 }, { "chapter_code": "T230", "chapter": "Note Miscellaneous operating expenses", "code": "MiscellaneousOperatingExpensesEnergy", "date": "2018-12-31;2018-01-01", "value": "-1961;4117", "name": "Energy", "bold": "no", "depth": 0 }, { "chapter_code": "T230", "chapter": "Note Miscellaneous operating expenses", "code": "MiscellaneousOperatingExpensesElectricity", "date": "2018-12-31;2018-01-01", "value": "-1961;4117", "name": "Electricity", "bold": "no", "depth": 0 }, { "chapter_code": "T230", "chapter": "Note Miscellaneous operating expenses", "code": "MiscellaneousOperatingExpensesMiscellaneousOfficeExpense", "date": "2018-12-31;2018-01-01", "value": "-34688;-36704", "name": "Miscellaneous office expenses", "bold": "no", "depth": 0 }, { "chapter_code": "T230", "chapter": "Note Miscellaneous operating expenses", "code": "MiscellaneousOperatingExpensesTravelExpense", "date": "2018-12-31;2018-01-01", "value": "-3543;-10751", "name": "Travel expense", "bold": "no", "depth": 0 }, { "chapter_code": "T230", "chapter": "Note Miscellaneous operating expenses", "code": "MiscellaneousOperatingExpensesTrainingExpense", "date": "2018-12-31;2018-01-01", "value": "-4680;-4704", "name": "Training expense", "bold": "no", "depth": 0 }, { "chapter_code": "T230", "chapter": "Note Miscellaneous operating expenses", "code": "MiscellaneousOperatingExpensesAllowanceForDoubtfulReceivables", "date": "2018-12-31;2018-01-01", "value": "-796;-927", "name": "Allowance for doubtful receivables", "bold": "no", "depth": 0 }, { "chapter_code": "T230", "chapter": "Note Miscellaneous operating expenses", "code": "MiscellaneousOperatingExpenses", "date": "2018-12-31;2018-01-01", "value": "-213477;-198969", "name": "Miscellaneous operating expenses", "bold": "no", "depth": 0 }, { "chapter_code": "T235", "chapter": "Note Labor expense", "code": "WageAndSalaryExpense", "date": "2018-12-31;2018-01-01", "value": "-921439;-941688", "name": "Wage and salary expense", "bold": "no", "depth": 0 }, { "chapter_code": "T235", "chapter": "Note Labor expense", "code": "SocialSecurityTaxes", "date": "2018-12-31;2018-01-01", "value": "-310637;-317323", "name": "Social security taxes", "bold": "no", "depth": 0 }, { "chapter_code": "T235", "chapter": "Note Labor expense", "code": "LaborExpense", "date": "2018-12-31;2018-01-01", "value": "-1251423;-1278085", "name": "Total labor expense", "bold": "no", "depth": 0 }, { "chapter_code": "T235", "chapter": "Note Labor expense", "code": "AverageNumberOfEmployeesInFullTimeEquivalentUnits", "date": "2018-12-31;2018-01-01", "value": "64;57", "name": "Average number of employees in full time equivalent units", "bold": "no", "depth": 0 } ], "net_sales_per_activity": [ { "annual_year": "2018", "net_sales": "1800546", "activity_code": "63991", "is_main": true }, { "annual_year": "2018", "net_sales": "170", "activity_code": "74301", "is_main": false } ], "period_start": "2018-01-01", "period_end": "2018-12-31", "registered_at": "2019-06-21" } ``` {% endtab %} {% tab title="400 " %} ```javascript { "error": "error", "code": 400, "message": "Only EST country supported in this request" } or { "error": "error", "code": 400, "message": "This doc_type is not supported" } ``` {% endtab %} {% tab title="401 Invalid token" %} ```javascript { "error": "error", "code": 401, "message": "Token is wrong" } ``` {% endtab %} {% tab title="402 Not enough credit" %} ```javascript { "error": "error", "code": 402, "message": "Monthly requests limit exceeded" } ``` {% endtab %} {% tab title="403 " %} ```javascript { "error": "error", "code": 403, "message": "This request is not allowed for you" } ``` {% endtab %} {% tab title="404 " %} ```c { "error": "error", "code": 404, "message": "No such company" } ``` {% endtab %} {% tab title="409 " %} ```c { "error": "error", "code": 409, "message": "Something went wrong" } ``` {% endtab %} {% tab title="422 " %} ```c { "error": "error", "code": 422, "message": "Schema validation error" } ``` {% endtab %} {% tab title="423 " %} ```c { "error": "error", "code": 423, "message": "Locked. Wait for previous request to complete" } ``` {% endtab %} {% tab title="500 " %} ```c { "error": "error", "code": 500, "message": "Something went wrong" } ``` {% endtab %} {% endtabs %} # getFinancialInformation TEST request - https\://in.bisnode.ee/rest\_dev/getFinancialInformation ## getFinancialInformation `POST` `https://in.bisnode.ee/rest/getFinancialInformation` **Needed Headers:** Content-type: application/json\ \ This endpoint allows you to get company key financial indicators for 3 last available annual years in database such as:\ `* Revenue`\ `* Profit/Loss`\ `* Equity`\ `* Short-term liabilities`\ `* etc.`\ \ Example Curl request:\ `curl -X POST -k -H 'Content-type: application/json' -i 'https://in.bisnode.ee/rest/getFinancialInformation' --data '{`\ `"token": "0c725874e737c8195de547f67692d8b976726561",`\ `"reg_code": "10117826",`\ `"country": "EST",`\ `"language": "en"`\ `}'` #### Query Parameters | Name | Type | Description | | --------- | ------ | -------------------------------------------------------------------- | | language | string | 2-letter language code. Must be "en", "et" or "ru". Default is "en". | | token | string | Your 'access token' (API key). | | reg\_code | string | Company registration number. | | country | string | 3-letter country code "EST" or "LVA". Default is "EST". | {% tabs %} {% tab title="200 This is just an example, the list is not full." %} ```javascript { "financial_information": [ { "annual_year": "2019", "net_sales": "111111", "net_sales_trend": 1.1111111111111111, "net_profit_loss": "12345", "net_profit_loss_trend": 222.1111111111111111, "total_profit_loss": "12345", "total_profit_loss_trend": 333.1111111111111111, "current_assets": "123456", "current_assets_trend": 3.1111111111111111, "equity": "1234567", "equity_trend": 1.1111111111111111, "short_term_liabilities": "301478", "short_term_liabilities_trend": 5.1111111111111111, "non_current_assets": null, "non_current_assets_trend": -100, "non_current_liabilities": null, "non_current_liabilities_trend": -100, "liabilities_and_equity": "1234567", "liabilities_and_equity_trend": 2.1111111111111111, "net_sales_consolidated": null, "net_sales_consolidated_trend": null, "net_profit_loss_consolidated": null, "net_profit_loss_consolidated_trend": null, "employees": "99", "employees_trend": 1.22, "employees_consolidated": null, "employees_consolidated_trend": null, "current_assets_consolidated": null, "current_assets_consolidated_trend": null, "equity_consolidated": null, "equity_consolidated_trend": null, "short_term_liabilities_consolidated": null, "short_term_liabilities_consolidated_trend": null, "liabilities_and_equity_consolidated": null, "liabilities_and_equity_consolidated_trend": null, "export_revenue": null }, { "annual_year": "2018", "net_sales": "111111", "net_sales_trend": -1.1111111111, "net_profit_loss": "1111", "net_profit_loss_trend": 0, "total_profit_loss": "1111", "total_profit_loss_trend": 0, "current_assets": "111111", "current_assets_trend": -1.1111111111, "equity": "111111", "equity_trend": 0.1111111111, "short_term_liabilities": "111111", "short_term_liabilities_trend": -1.111111111, "non_current_assets": "111111", "non_current_assets_trend": -1.11111111111, "non_current_liabilities": "11111", "non_current_liabilities_trend": 0, "liabilities_and_equity": "1111111", "liabilities_and_equity_trend": -1.11111111, "net_sales_consolidated": null, "net_sales_consolidated_trend": 0, "net_profit_loss_consolidated": null, "net_profit_loss_consolidated_trend": 0, "employees": "11", "employees_trend": 11.11111111, "employees_consolidated": null, "employees_consolidated_trend": 0, "current_assets_consolidated": null, "current_assets_consolidated_trend": 0, "equity_consolidated": null, "equity_consolidated_trend": 0, "short_term_liabilities_consolidated": null, "short_term_liabilities_consolidated_trend": 0, "liabilities_and_equity_consolidated": null, "liabilities_and_equity_consolidated_trend": 0, "export_revenue": null }, { "annual_year": "2017", "net_sales": "1111111", "net_sales_trend": 11.111111111, "net_profit_loss": "-1111", "net_profit_loss_trend": 0, "total_profit_loss": "-1111", "total_profit_loss_trend": 0, "current_assets": "1111111", "current_assets_trend": 0.111111111, "equity": "1111111", "equity_trend": -1.11111111, "short_term_liabilities": "111111", "short_term_liabilities_trend": 11.111111111, "non_current_assets": "111111", "non_current_assets_trend": 11.1111111111, "non_current_liabilities": "0", "non_current_liabilities_trend": -111, "liabilities_and_equity": "111111", "liabilities_and_equity_trend": 1.111111111, "net_sales_consolidated": null, "net_sales_consolidated_trend": 0, "net_profit_loss_consolidated": null, "net_profit_loss_consolidated_trend": 0, "employees": "11", "employees_trend": 0, "employees_consolidated": null, "employees_consolidated_trend": 0, "current_assets_consolidated": null, "current_assets_consolidated_trend": 0, "equity_consolidated": null, "equity_consolidated_trend": 0, "short_term_liabilities_consolidated": null, "short_term_liabilities_consolidated_trend": 0, "liabilities_and_equity_consolidated": null, "liabilities_and_equity_consolidated_trend": 0, "export_revenue": null } ], "financial_ratios": [ { "annual_year": "2019", "roa": 1.1111111111111111, "equity_ratio": 11.111111111111111, "quick_ratio": 1.1111111111111111, "profit_margin": 1.1111111111111111, "revenue_per_emploee": 11111.11111111111, "profit_per_emploee": 111.111111111111 }, { "annual_year": "2018", "roa": 0.1111111111, "equity_ratio": 11.1111111111, "quick_ratio": 1.11111111111, "profit_margin": 0.11111111111, "revenue_per_emploee": 11111.1111, "profit_per_emploee": 11.111111 }, { "annual_year": "2017", "roa": -1.11111111111, "equity_ratio": 11.1111111111, "quick_ratio": 1.111111111111, "profit_margin": -1.111111111, "revenue_per_emploee": 11111.1111111111, "profit_per_emploee": -111.1111111111 } ] } ``` {% endtab %} {% tab title="400 Invalid country code" %} ```javascript { "error": "error", "code": 400, "message": "Only EST and LVA countries are supported in this request" } ``` {% endtab %} {% tab title="401 Invalid token" %} ```javascript { "error": "error", "code": 401, "message": "Token is wrong" } ``` {% endtab %} {% tab title="402 Not enough credit" %} ```javascript { "error": "error", "code": 402, "message": "Monthly requests limit exceeded" } ``` {% endtab %} {% tab title="403 " %} ```javascript { "error": "error", "code": 403, "message": "This request is not allowed for you" } ``` {% endtab %} {% tab title="404 Could not find a company matching this query" %} ```javascript { "error": "error", "code": 404, "message": "No such company" } ``` {% endtab %} {% tab title="409 " %} ```javascript { "error": "error", "code": 409, "message": "Something went wrong" } ``` {% endtab %} {% tab title="422 Validation failed" %} ```javascript { "error": "error", "code": 422, "message": "Schema validation error" } ``` {% endtab %} {% tab title="423 " %} ```javascript { "error": "error", "code": 423, "message": "Locked. Wait for previous request to complete" } ``` {% endtab %} {% tab title="500 " %} ```javascript { "error": "error", "code": 500, "message": "Internal Server Error" } ``` {% endtab %} {% endtabs %} # getFinancialStatements TEST request - https\://in.bisnode.ee/rest\_dev/getFinancialStatements ## getFinancialStatements `POST` `https://in.bisnode.ee/rest/getFinancialStatements` **Needed Headers:** Content-type: application/json\ \ This endpoint allows you to get company financial statemanets such as:\ `* full income statement`\ `* balance sheet`\ `* cash flows`\ \ Example Curl request:\ `curl -X POST -k -H 'Content-type: application/json' -i 'https://in.bisnode.ee/rest/getFinancialStatements' --data '{`\ `"token": "0c725874e737c8195de547f67692d8b976726561",`\ `"reg_code": "10117826",`\ `"annual_year": "2018",`\ `"country": "EST",`\ `"language": "en"`\ `}'` #### Query Parameters | Name | Type | Description | | ------------ | ------ | --------------------------------------------------- | | language | string | 2-letter language code. Must be "en", "et" or "ru". | | token | string | Your 'access token' (API key). | | reg\_code | string | Company registration number. | | annual\_year | string | Annual year | | country | string | 3-letter country code "EST". Default is "EST". | {% tabs %} {% tab title="200 This is just an example." %} ```javascript [ { "chapter_code": "T001A", "chapter": "Statement of financial position (in the order of growing liquidity)", "code": "StatementOfFinancialPositionAbstract", "date": "2018-12-31;2018-01-01", "value": ";", "name": "Statement of financial position", "bold": "no", "depth": 0 }, { "chapter_code": "T001A", "chapter": "Statement of financial position (in the order of growing liquidity)", "code": "AssetsAbstract", "date": "2018-12-31;2018-01-01", "value": ";", "name": "Assets", "bold": "no", "depth": 0 }, { "chapter_code": "T001A", "chapter": "Statement of financial position (in the order of growing liquidity)", "code": "NonCurrentAssetsAbstract", "date": "2018-12-31;2018-01-01", "value": ";", "name": "Non-current assets", "bold": "no", "depth": 0 }, { "chapter_code": "T001A", "chapter": "Statement of financial position (in the order of growing liquidity)", "code": "IntangibleAssets", "date": "2018-12-31;2018-01-01", "value": "85442;101845", "name": "Intangible assests", "bold": "no", "depth": 0 }, { "chapter_code": "T001A", "chapter": "Statement of financial position (in the order of growing liquidity)", "code": "PropertyPlantAndEquipment", "date": "2018-12-31;2018-01-01", "value": "94076;85904", "name": "Property, plant and equipment", "bold": "no", "depth": 0 }, { "chapter_code": "T001A", "chapter": "Statement of financial position (in the order of growing liquidity)", "code": "LongTermReceivablesAndPrepayments", "date": "2018-12-31;2018-01-01", "value": "14792;14792", "name": "Long term receivables and prepayments", "bold": "no", "depth": 0 }, { "chapter_code": "T001A", "chapter": "Statement of financial position (in the order of growing liquidity)", "code": "NonCurrentAssets", "date": "2018-12-31;2018-01-01", "value": "194310;202541", "name": "Total non-current assets", "bold": "no", "depth": 0 }, { "chapter_code": "T001A", "chapter": "Statement of financial position (in the order of growing liquidity)", "code": "CurrentAssetsAbstract", "date": "2018-12-31;2018-01-01", "value": ";", "name": "Current assets", "bold": "no", "depth": 0 }, { "chapter_code": "T001A", "chapter": "Statement of financial position (in the order of growing liquidity)", "code": "ShortTermReceivablesAndPrepayments", "date": "2018-12-31;2018-01-01", "value": "187060;249252", "name": "Short term receivables and prepayments", "bold": "no", "depth": 0 }, { "chapter_code": "T001A", "chapter": "Statement of financial position (in the order of growing liquidity)", "code": "CashAndCashEquivalents", "date": "2018-12-31;2018-01-01", "value": "1319036;1274359", "name": "Cash and cash equivalents", "bold": "no", "depth": 0 }, { "chapter_code": "T001A", "chapter": "Statement of financial position (in the order of growing liquidity)", "code": "CurrentAssets", "date": "2018-12-31;2018-01-01", "value": "1506096;1523611", "name": "Total current assets", "bold": "no", "depth": 0 }, { "chapter_code": "T001A", "chapter": "Statement of financial position (in the order of growing liquidity)", "code": "Assets", "date": "2018-12-31;2018-01-01", "value": "1700406;1726152", "name": "Total assets", "bold": "no", "depth": 0 }, { "chapter_code": "T001A", "chapter": "Statement of financial position (in the order of growing liquidity)", "code": "LiabilitiesAndEquityAbstract", "date": "2018-12-31;2018-01-01", "value": ";", "name": "Liabilities and equity", "bold": "no", "depth": 0 }, { "chapter_code": "T001A", "chapter": "Statement of financial position (in the order of growing liquidity)", "code": "EquityAbstract", "date": "2018-12-31;2018-01-01", "value": ";", "name": "Equity", "bold": "no", "depth": 0 }, { "chapter_code": "T001A", "chapter": "Statement of financial position (in the order of growing liquidity)", "code": "IssuedCapital2", "date": "2018-12-31;2018-01-01", "value": "25560;25560", "name": "Issued capital", "bold": "no", "depth": 0 }, { "chapter_code": "T001A", "chapter": "Statement of financial position (in the order of growing liquidity)", "code": "StatutoryReserveCapital", "date": "2018-12-31;2018-01-01", "value": "2556;2556", "name": "Statutory reserve capital", "bold": "no", "depth": 0 }, { "chapter_code": "T001A", "chapter": "Statement of financial position (in the order of growing liquidity)", "code": "RetainedEarningsLoss", "date": "2018-12-31;2018-01-01", "value": "1367707;1404390", "name": "Retained earnings (loss)", "bold": "no", "depth": 0 }, { "chapter_code": "T001A", "chapter": "Statement of financial position (in the order of growing liquidity)", "code": "AnnualPeriodProfitLoss", "date": "2018-12-31;2018-01-01", "value": "6073;-36683", "name": "Annual period profit (loss)", "bold": "no", "depth": 0 }, { "chapter_code": "T001A", "chapter": "Statement of financial position (in the order of growing liquidity)", "code": "Equity", "date": "2018-12-31;2018-01-01", "value": "1401896;1395823", "name": "Total equity", "bold": "no", "depth": 0 }, { "chapter_code": "T001A", "chapter": "Statement of financial position (in the order of growing liquidity)", "code": "LiabilitiesAbstract", "date": "2018-12-31;2018-01-01", "value": ";", "name": "Liabilities", "bold": "no", "depth": 0 }, { "chapter_code": "T001A", "chapter": "Statement of financial position (in the order of growing liquidity)", "code": "NonCurrentLiabilitiesAbstract", "date": "2018-12-31;2018-01-01", "value": ";", "name": "Non-current liabilities", "bold": "no", "depth": 0 }, { "chapter_code": "T001A", "chapter": "Statement of financial position (in the order of growing liquidity)", "code": "LongTermLoanLiabilities", "date": "2018-12-31;2018-01-01", "value": "12162;0", "name": "Long term loan liablities", "bold": "no", "depth": 0 }, { "chapter_code": "T001A", "chapter": "Statement of financial position (in the order of growing liquidity)", "code": "NonCurrentLiabilities", "date": "2018-12-31;2018-01-01", "value": "12162;0", "name": "Total non-current liabilities", "bold": "no", "depth": 0 }, { "chapter_code": "T001A", "chapter": "Statement of financial position (in the order of growing liquidity)", "code": "CurrentLiabilitiesAbstract", "date": "2018-12-31;2018-01-01", "value": ";", "name": "Current liabilities", "bold": "no", "depth": 0 }, { "chapter_code": "T001A", "chapter": "Statement of financial position (in the order of growing liquidity)", "code": "ShortTermLoanLiabilities", "date": "2018-12-31;2018-01-01", "value": "2403;5638", "name": "Short term loan liablities", "bold": "no", "depth": 0 }, { "chapter_code": "T001A", "chapter": "Statement of financial position (in the order of growing liquidity)", "code": "ShortTermPayablesAndPrepayments", "date": "2018-12-31;2018-01-01", "value": "283945;324691", "name": "Short term payables and prepayments", "bold": "no", "depth": 0 }, { "chapter_code": "T001A", "chapter": "Statement of financial position (in the order of growing liquidity)", "code": "CurrentLiabilities", "date": "2018-12-31;2018-01-01", "value": "286348;330329", "name": "Total current liabilities", "bold": "no", "depth": 0 }, { "chapter_code": "T001A", "chapter": "Statement of financial position (in the order of growing liquidity)", "code": "Liabilities", "date": "2018-12-31;2018-01-01", "value": "298510;330329", "name": "Total liabilities", "bold": "no", "depth": 0 }, { "chapter_code": "T001A", "chapter": "Statement of financial position (in the order of growing liquidity)", "code": "LiabilitiesAndEquity", "date": "2018-12-31;2018-01-01", "value": "1700406;1726152", "name": "Total liabilities and equity", "bold": "no", "depth": 0 }, { "chapter_code": "T002", "chapter": "Income statement", "code": "IncomeStatementAbstract", "date": "2018-12-31;2018-01-01", "value": ";", "name": "Income statement", "bold": "no", "depth": 0 }, { "chapter_code": "T002", "chapter": "Income statement", "code": "Revenue", "date": "2018-12-31;2018-01-01", "value": "1800716;1841065", "name": "Revenue", "bold": "no", "depth": 0 }, { "chapter_code": "T002", "chapter": "Income statement", "code": "OtherIncome", "date": "2018-12-31;2018-01-01", "value": "5426;1380", "name": "Other income", "bold": "no", "depth": 0 }, { "chapter_code": "T002", "chapter": "Income statement", "code": "RawMaterialsAndConsumablesUsed", "date": "2018-12-31;2018-01-01", "value": "-246282;-322999", "name": "Raw materials and consumables used", "bold": "no", "depth": 0 }, { "chapter_code": "T002", "chapter": "Income statement", "code": "OtherOperatingExpense", "date": "2018-12-31;2018-01-01", "value": "-213477;-198969", "name": "Other operating expense", "bold": "no", "depth": 0 }, { "chapter_code": "T002", "chapter": "Income statement", "code": "EmployeeExpense", "date": "2018-12-31;2018-01-01", "value": "-1251423;-1278085", "name": "Employee expense", "bold": "no", "depth": 0 }, { "chapter_code": "T002", "chapter": "Income statement", "code": "DepreciationAndImpairmentLossReversal", "date": "2018-12-31;2018-01-01", "value": "-80723;-71095", "name": "Depreciation and impairment loss (reversal)", "bold": "no", "depth": 0 }, { "chapter_code": "T002", "chapter": "Income statement", "code": "OtherExpense", "date": "2018-12-31;2018-01-01", "value": "-7839;-7270", "name": "Other expense", "bold": "no", "depth": 0 }, { "chapter_code": "T002", "chapter": "Income statement", "code": "TotalProfitLoss", "date": "2018-12-31;2018-01-01", "value": "6398;-35973", "name": "Profit (loss)", "bold": "no", "depth": 0 }, { "chapter_code": "T002", "chapter": "Income statement", "code": "InterestIncome", "date": "2018-12-31;2018-01-01", "value": "52;0", "name": "Interest income", "bold": "no", "depth": 0 }, { "chapter_code": "T002", "chapter": "Income statement", "code": "InterestExpenses", "date": "2018-12-31;2018-01-01", "value": "-377;-710", "name": "Interest expenses", "bold": "no", "depth": 0 }, { "chapter_code": "T002", "chapter": "Income statement", "code": "TotalProfitLossBeforeTax", "date": "2018-12-31;2018-01-01", "value": "6073;-36683", "name": "Profit (loss) before tax", "bold": "no", "depth": 0 }, { "chapter_code": "T002", "chapter": "Income statement", "code": "TotalAnnualPeriodProfitLoss", "date": "2018-12-31;2018-01-01", "value": "6073;-36683", "name": "Annual period profit (loss)", "bold": "no", "depth": 0 }, { "chapter_code": "T004", "chapter": "Statement of cash flows", "code": "StatementOfCashFlowsAbstract", "date": "2018-12-31;2018-01-01", "value": ";", "name": "Statement of cash flows", "bold": "no", "depth": 0 }, { "chapter_code": "T004", "chapter": "Statement of cash flows", "code": "CashFlowsFromOperatingActivitiesAbstract", "date": "2018-12-31;2018-01-01", "value": ";", "name": "Cash flows from operating activities", "bold": "no", "depth": 0 }, { "chapter_code": "T004", "chapter": "Statement of cash flows", "code": "TotalProfitLoss", "date": "2018-12-31;2018-01-01", "value": "6398;-35973", "name": "Profit (loss)", "bold": "no", "depth": 0 }, { "chapter_code": "T004", "chapter": "Statement of cash flows", "code": "AdjustmentsAbstract", "date": "2018-12-31;2018-01-01", "value": ";", "name": "Adjustments", "bold": "no", "depth": 0 }, { "chapter_code": "T004", "chapter": "Statement of cash flows", "code": "DepreciationAndImpairmentLossReversalNeg", "date": "2018-12-31;2018-01-01", "value": "80723;71095", "name": "Depreciation and impairment loss (reversal)", "bold": "no", "depth": 0 }, { "chapter_code": "T004", "chapter": "Statement of cash flows", "code": "ProfitLossFromSaleOfNonCurrentAssets", "date": "2018-12-31;2018-01-01", "value": "-3506;0", "name": "Profit (loss) from sale of non-current assets", "bold": "no", "depth": 0 }, { "chapter_code": "T004", "chapter": "Statement of cash flows", "code": "Adjustments", "date": "2018-12-31;2018-01-01", "value": "77217;71095", "name": "Total adjustments", "bold": "no", "depth": 0 }, { "chapter_code": "T004", "chapter": "Statement of cash flows", "code": "ChangesInReceivablesAndPrepaymentsRelatedToOperatingActivities", "date": "2018-12-31;2018-01-01", "value": "62192;-734", "name": "Changes in receivables and prepayments related to operating activities", "bold": "no", "depth": 0 }, { "chapter_code": "T004", "chapter": "Statement of cash flows", "code": "ChangesInPayablesAndPrepaymentsRelatedToOperatingActivities", "date": "2018-12-31;2018-01-01", "value": "-42578;104405", "name": "Changes in payables and prepayments related to operating activities", "bold": "no", "depth": 0 }, { "chapter_code": "T004", "chapter": "Statement of cash flows", "code": "OperatingActivitiesIntrestPaid", "date": "2018-12-31;2018-01-01", "value": "-377;-436", "name": "Interest paid", "bold": "no", "depth": 0 }, { "chapter_code": "T004", "chapter": "Statement of cash flows", "code": "CashFlowsFromOperatingActivities", "date": "2018-12-31;2018-01-01", "value": "102852;138357", "name": "Total cash flows from operating activities", "bold": "no", "depth": 0 }, { "chapter_code": "T004", "chapter": "Statement of cash flows", "code": "CashFlowsFromInvestingActivitiesAbstract", "date": "2018-12-31;2018-01-01", "value": ";", "name": "Cash flows from investing activities", "bold": "no", "depth": 0 }, { "chapter_code": "T004", "chapter": "Statement of cash flows", "code": "InvestingActivitiesPurchaseOfPropertyPlantAndEquipmentAndIntangibleAssets", "date": "2018-12-31;2018-01-01", "value": "-56069;-124720", "name": "Purchase of property, plant and equipment and intangible assets", "bold": "no", "depth": 0 }, { "chapter_code": "T004", "chapter": "Statement of cash flows", "code": "InvestingActivitiesIntrestReceived", "date": "2018-12-31;2018-01-01", "value": "52;109", "name": "Interest received", "bold": "no", "depth": 0 }, { "chapter_code": "T004", "chapter": "Statement of cash flows", "code": "CashFlowsFromInvestingActivities", "date": "2018-12-31;2018-01-01", "value": "-56017;-124611", "name": "Total cash flows from investing activities", "bold": "no", "depth": 0 }, { "chapter_code": "T004", "chapter": "Statement of cash flows", "code": "CashFlowsFromFinancingActivitiesAbstract", "date": "2018-12-31;2018-01-01", "value": ";", "name": "Cash flows from financing activities", "bold": "no", "depth": 0 }, { "chapter_code": "T004", "chapter": "Statement of cash flows", "code": "FinancingActivitiesProceedsFromFinanceLease", "date": "2018-12-31;2018-01-01", "value": "-2158;-1863", "name": "Proceeds from finance lease", "bold": "no", "depth": 0 }, { "chapter_code": "T004", "chapter": "Statement of cash flows", "code": "CashFlowsFromFinancingActivities", "date": "2018-12-31;2018-01-01", "value": "-2158;-1863", "name": "Total cash flows from financing activities", "bold": "no", "depth": 0 }, { "chapter_code": "T004", "chapter": "Statement of cash flows", "code": "CashFlows", "date": "2018-12-31;2018-01-01", "value": "44677;11883", "name": "Total cash flows", "bold": "no", "depth": 0 }, { "chapter_code": "T004", "chapter": "Statement of cash flows", "code": "CashAndCashEquivalentsAtBeginningOfPeriod", "date": "2018-12-31;2018-01-01", "value": "1274359;1262476", "name": "Cash and cash equivalents at beginning of period", "bold": "no", "depth": 0 }, { "chapter_code": "T004", "chapter": "Statement of cash flows", "code": "ChangeInCashAndCashEquivalents", "date": "2018-12-31;2018-01-01", "value": "44677;11883", "name": "Change in cash and cash equivalents", "bold": "no", "depth": 0 }, { "chapter_code": "T004", "chapter": "Statement of cash flows", "code": "CashAndCashEquivalentsAtEndOfPeriod", "date": "2018-12-31;2018-01-01", "value": "1319036;1274359", "name": "Cash and cash equivalents at end of period", "bold": "no", "depth": 0 }, { "chapter_code": "T230", "chapter": "Note Miscellaneous operating expenses", "code": "MiscellaneousOperatingExpensesLeases", "date": "2018-12-31;2018-01-01", "value": "-60890;-34647", "name": "Leases", "bold": "no", "depth": 0 }, { "chapter_code": "T230", "chapter": "Note Miscellaneous operating expenses", "code": "MiscellaneousOperatingExpensesEnergy", "date": "2018-12-31;2018-01-01", "value": "-1961;4117", "name": "Energy", "bold": "no", "depth": 0 }, { "chapter_code": "T230", "chapter": "Note Miscellaneous operating expenses", "code": "MiscellaneousOperatingExpensesElectricity", "date": "2018-12-31;2018-01-01", "value": "-1961;4117", "name": "Electricity", "bold": "no", "depth": 0 }, { "chapter_code": "T230", "chapter": "Note Miscellaneous operating expenses", "code": "MiscellaneousOperatingExpensesMiscellaneousOfficeExpense", "date": "2018-12-31;2018-01-01", "value": "-34688;-36704", "name": "Miscellaneous office expenses", "bold": "no", "depth": 0 }, { "chapter_code": "T230", "chapter": "Note Miscellaneous operating expenses", "code": "MiscellaneousOperatingExpensesTravelExpense", "date": "2018-12-31;2018-01-01", "value": "-3543;-10751", "name": "Travel expense", "bold": "no", "depth": 0 }, { "chapter_code": "T230", "chapter": "Note Miscellaneous operating expenses", "code": "MiscellaneousOperatingExpensesTrainingExpense", "date": "2018-12-31;2018-01-01", "value": "-4680;-4704", "name": "Training expense", "bold": "no", "depth": 0 }, { "chapter_code": "T230", "chapter": "Note Miscellaneous operating expenses", "code": "MiscellaneousOperatingExpensesAllowanceForDoubtfulReceivables", "date": "2018-12-31;2018-01-01", "value": "-796;-927", "name": "Allowance for doubtful receivables", "bold": "no", "depth": 0 }, { "chapter_code": "T230", "chapter": "Note Miscellaneous operating expenses", "code": "MiscellaneousOperatingExpenses", "date": "2018-12-31;2018-01-01", "value": "-213477;-198969", "name": "Miscellaneous operating expenses", "bold": "no", "depth": 0 }, { "chapter_code": "T235", "chapter": "Note Labor expense", "code": "WageAndSalaryExpense", "date": "2018-12-31;2018-01-01", "value": "-921439;-941688", "name": "Wage and salary expense", "bold": "no", "depth": 0 }, { "chapter_code": "T235", "chapter": "Note Labor expense", "code": "SocialSecurityTaxes", "date": "2018-12-31;2018-01-01", "value": "-310637;-317323", "name": "Social security taxes", "bold": "no", "depth": 0 }, { "chapter_code": "T235", "chapter": "Note Labor expense", "code": "LaborExpense", "date": "2018-12-31;2018-01-01", "value": "-1251423;-1278085", "name": "Total labor expense", "bold": "no", "depth": 0 }, { "chapter_code": "T235", "chapter": "Note Labor expense", "code": "AverageNumberOfEmployeesInFullTimeEquivalentUnits", "date": "2018-12-31;2018-01-01", "value": "64;57", "name": "Average number of employees in full time equivalent units", "bold": "no", "depth": 0 } ] ``` {% endtab %} {% tab title="400 Invalid country code or no annual year" %} ```javascript { "error": "error", "code": 400, "message": "Only EST country supported in this request" } or { "error": "error", "code": 400, "message": "No annual year selected" } ``` {% endtab %} {% tab title="401 Invalid token" %} ```javascript { "error": "error", "code": 401, "message": "Token is wrong" } ``` {% endtab %} {% tab title="402 Not enough credit" %} ```javascript { "error": "error", "code": 402, "message": "Monthly requests limit exceeded" } ``` {% endtab %} {% tab title="403 " %} ```javascript { "error": "error", "code": 403, "message": "This request is not allowed for you" } ``` {% endtab %} {% tab title="404 Could not find a company matching this query" %} ```javascript { "error": "error", "code": 404, "message": "No such company" } ``` {% endtab %} {% tab title="409 " %} ```javascript { "error": "error", "code": 409, "message": "Something went wrong" } ``` {% endtab %} {% tab title="422 Validation failed" %} ```javascript { "error": "error", "code": 422, "message": "Schema validation error" } ``` {% endtab %} {% tab title="423 " %} ```javascript { "error": "error", "code": 423, "message": "Locked. Wait for previous request to complete" } ``` {% endtab %} {% tab title="500 " %} ```javascript { "error": "error", "code": 500, "message": "Internal Server Error" } ``` {% endtab %} {% endtabs %} # getTaxInformation TEST request - https\://in.bisnode.ee/rest\_dev/getTaxInformation ## getTaxInformation `POST` `https://in.bisnode.ee/rest/getTaxInformation` **Needed Headers:** Content-type: application/json\ \ This endpoint allows you to get company tax information (quarterly) from Tax Authority such as:\ `* Paid state taxes`\ `* Paid labor taxes`\ `* Turnover`\ `* Number of employees`\ \ Example Curl request:\ `curl -X POST -k -H 'Content-type: application/json' -i 'https://in.bisnode.ee/rest/getTaxInformation' --data '{`\ `"token": "0c725874e737c8195de547f67692d8b976726561",`\ `"reg_code": "10117826",`\ `"country": "EST",`\ `"language": "en"`\ `}'` #### Query Parameters | Name | Type | Description | | --------- | ------ | -------------------------------------------------------------------- | | language | string | 2-letter language code. Must be "en", "et" or "ru". Default is "en". | | token | string | Your 'access token' (API key). | | reg\_code | string | Company registration number. | | country | string | 3-letter country code "EST". Default is "EST". | {% tabs %} {% tab title="200 " %} ```javascript [ { "year": "2018", "quarter": "4", "state_taxes_paid": 11111.06, "labor_taxes_paid": 11111.41, "turnover": 11111.65, "employees": 11 }, { "year": "2018", "quarter": "3", "state_taxes_paid": 11111.46, "labor_taxes_paid": 11111.72, "turnover": 11111.62, "employees": 11 }, { "year": "2018", "quarter": "2", "state_taxes_paid": 11111.01, "labor_taxes_paid": 11111.39, "turnover": 11111.63, "employees": 11 }, { "year": "2018", "quarter": "1", "state_taxes_paid": 11111.87, "labor_taxes_paid": 11111.37, "turnover": 11111.75, "employees": 11 } ] ``` {% endtab %} {% tab title="400 Invalid country code" %} ```javascript { "error": "error", "code": 400, "message": "Only EST country supported in this request" } ``` {% endtab %} {% tab title="401 Invalid token" %} ```javascript { "error": "error", "code": 401, "message": "Token is wrong" } ``` {% endtab %} {% tab title="402 Not enough credit" %} ```javascript { "error": "error", "code": 402, "message": "Monthly requests limit exceeded" } ``` {% endtab %} {% tab title="403 " %} ```javascript { "error": "error", "code": 403, "message": "This request is not allowed for you" } ``` {% endtab %} {% tab title="404 Could not find a company matching this query" %} ```javascript { "error": "error", "code": 404, "message": "No such company" } ``` {% endtab %} {% tab title="409 " %} ```javascript { "error": "error", "code": 409, "message": "Something went wrong" } ``` {% endtab %} {% tab title="422 Validation failed" %} ```javascript { "error": "error", "code": 422, "message": "Schema validation error" } ``` {% endtab %} {% tab title="423 " %} ```javascript { "error": "error", "code": 423, "message": "Locked. Wait for previous request to complete" } ``` {% endtab %} {% tab title="500 " %} ```javascript { "error": "error", "code": 500, "message": "Internal Server Error" } ``` {% endtab %} {% endtabs %} # getSalaryInformation TEST request - https\://in.bisnode.ee/rest\_dev/getSalaryInformation ## getSalaryInformation `POST` `https://in.bisnode.ee/rest/getSalaryInformation` **Needed Headers:** Content-type: application/json\ \ This endpoint allows you to get average salary paid in company and its comparison to the industry for every year with analysis such as:\ `* Min salary`\ `* Salary slices`\ `* Max salary`\ `* Industrial average salary`\ `* Industrial median salary`\ `* Step`\ `* Total companies`\ \ Example Curl request:\ `curl -X POST -k -H 'Content-type: application/json' -i 'https://in.bisnode.ee/rest/getSalaryInformation' --data '{`\ `"token": "0c725874e737c8195de547f67692d8b976726561",`\ `"reg_code": "10117826",`\ `"country": "EST",`\ `"language": "en"`\ `}'` #### Query Parameters | Name | Type | Description | | --------- | ------ | -------------------------------------------------------------------- | | language | string | 2-letter language code. Must be "en", "et" or "ru". Default is "en". | | token | string | Your 'access token' (API key). | | reg\_code | string | Company registration number. | | country | string | 3-letter country code "EST". Default is "EST". | {% tabs %} {% tab title="200 " %} ```javascript [ { "annual_year": 2017, "company_avg_salary": 1377, "analysis": { "min_salary": 175, "slice1_salary": 787, "slice2_salary": 1615, "max_salary": 4049, "industrial_avg_salary": 2112, "industrial_median_salary": 1021, "step": 8.7, "total_companies": 26 } }, { "annual_year": 2016, "company_avg_salary": 1084, "analysis": [] }, { "annual_year": 2015, "company_avg_salary": 1037, "analysis": [] } ] ``` {% endtab %} {% tab title="400 Invalid country code" %} ```javascript { "error": "error", "code": 400, "message": "Only EST country supported in this request" } ``` {% endtab %} {% tab title="401 Invalid token" %} ```javascript { "error": "error", "code": 401, "message": "Token is wrong" } ``` {% endtab %} {% tab title="402 Not enough credit" %} ```javascript { "error": "error", "code": 402, "message": "Monthly requests limit exceeded" } ``` {% endtab %} {% tab title="403 " %} ```javascript { "error": "error", "code": 403, "message": "This request is not allowed for you" } ``` {% endtab %} {% tab title="404 Could not find a company matching this query" %} ```javascript { "error": "error", "code": 404, "message": "No such company" } ``` {% endtab %} {% tab title="409 " %} ```javascript { "error": "error", "code": 409, "message": "Something went wrong" } ``` {% endtab %} {% tab title="422 Validation failed" %} ```javascript { "error": "error", "code": 422, "message": "Schema validation error" } ``` {% endtab %} {% tab title="423 " %} ```javascript { "error": "error", "code": 423, "message": "Locked. Wait for previous request to complete" } ``` {% endtab %} {% tab title="500 " %} ```javascript { "error": "error", "code": 500, "message": "Internal Server Error" } ``` {% endtab %} {% endtabs %} # getImmovables TEST request - https\://in.bisnode.ee/rest\_dev/getImmovables ## getImmovables `POST` `https://in.bisnode.ee/rest/getImmovables` **Needed Headers:** Content-type: application/json\ \ This endpoint allows you to get real estate information of a **company** or a **person** such as:\ `* Type`\ `* Cadastral code`\ `* Address`\ `* Area in m2`\ `* Registry code`\ `* Purpose`\ \ Example Curl request:\ `curl -X POST -k -H 'Content-type: application/json' -i 'https://in.bisnode.ee/rest/getImmovables' --data '{`\ `"token": "0c725874e737c8195de547f67692d8b976726561",`\ `"code": "10117826",`\ `"language": "en"`\ `}'` #### Query Parameters | Name | Type | Description | | -------- | ------ | ------------------------------------------------------------------- | | language | string | 2-letter language code. Must be "en", "et" or "ru. Default is "en". | | token | string | Your 'access token' (API key). | | code | string | Company registration number or Personal ID code. | {% tabs %} {% tab title="200 " %} ```javascript { "immovable_no": "111701", "type": "Kinnisasi", "cadastral_code": "11111:111:11111", "address": "ABC tn 1, Haabersti linnaosa, Tallinn, Harju maakond", "area": "1111,0 m2", "apt_no": "*", "registry_code_of_apartment_association": "", "purpose": "\u00c4rimaa 100%" } ``` {% endtab %} {% tab title="400 Missing code" %} ```javascript { "error": "error", "code": 400, "message": "Code is missing" } ``` {% endtab %} {% tab title="401 Invalid token" %} ```javascript { "error": "error", "code": 401, "message": "Token is wrong" } ``` {% endtab %} {% tab title="402 Not enough credit" %} ```javascript { "error": "error", "code": 402, "message": "Monthly requests limit exceeded" } ``` {% endtab %} {% tab title="403 " %} ```javascript { "error": "error", "code": 403, "message": "This request is not allowed for you" } ``` {% endtab %} {% tab title="409 " %} ```javascript { "error": "error", "code": 409, "message": "Something went wrong" } ``` {% endtab %} {% tab title="422 Validation failed" %} ```javascript { "error": "error", "code": 422, "message": "Schema validation error" } ``` {% endtab %} {% tab title="423 " %} ```javascript { "error": "error", "code": 423, "message": "Locked. Wait for previous request to complete" } ``` {% endtab %} {% tab title="500 " %} ```javascript { "error": "error", "code": 500, "message": "Internal Server Error" } ``` {% endtab %} {% endtabs %} # Company credit report TEST request - https\://in.bisnode.ee/rest\_dev/getCreditReportTranslated ## getCreditReportTranslated `POST` `https://in.bisnode.ee/rest/getCreditReportTranslated` **Needed Headers:** Content-type: application/json\ \ Includes full information about a company needed to make fully informed credit decision.\ `* General Information`\ `* Previous names`\ `* Contacts`\ `* Payment remarks`\ `* Current tax arrears`\ `* Tax arrears history`\ `* Enforcement notices`\ `* Court decisions on debt`\ `* Full management board`\ `* Normal rights`\ `* Specific rights`\ `* Export countries`\ `* Activities`\ `* Industrial average`\ `* Financial information`\ `* Financial rates`\ `* Tax Information`\ `* Consolidated finances`\ `* AAA rating`\ `* Shareholders`\ `* Financial Statements`\ \ Example Curl request:\ `curl -X POST -k -H 'Content-type: application/json' -i 'https://in.bisnode.ee/rest/getCreditReportTranslated' --data '{`\ `"token": "0c725874e737c8195de547f67692d8b976726561",`\ `"reg_code": "10117826",`\ `"type": "full",`\ `"country": "EST",`\ `"language": "en"`\ `}'` #### Query Parameters | Name | Type | Description | | --------- | ------ | -------------------------------------------------------------------- | | language | string | 2-letter language code. Must be "en", "et" or "ru". Default is "en". | | token | string | Your 'access token' (API key). | | reg\_code | string | Company registration number. | | type | string | Type of credit report "full". | | country | string | 3-letter country code "EST". Default is "EST". | {% tabs %} {% tab title="200 This is just an example of full credit report. Some similar fields are deleted(e.g. some annual statistics, financial statistics, etc.)" %} ```javascript { "header": { "created_at": "30\/07\/2019 16:39:56", "created_by": "BISNODE ESTONIA AS", "generator": "CreditReportCalculator v1.7" }, "report": { "pdf": "", "html": "", "created_at": "30\/07\/2019 16:39:56", "type": "full" }, "general": { "company_id": "111111", "company_name": "ABC AS", "company_type": { "type": "LEGAL_FORM_EST", "code": "AS", "et": "Aktsiaselts", "en": "Public limited company", "ru": "\u0410\u043a\u0446" }, "status": { "type": "LEGAL_STATUS_EST", "code": "A", "et": "Aktiivne", "en": "Active", "ru": "\u0410\u043a\u0442\u0438\u0432\u043d\u044b\u0439" }, "deletion_date": null, "registration_number": "11111111", "registration_date": "1999-01-01", "registered_capital": "11111", "registered_capital_currency": { "type": "VALUUTAD", "code": "EUR", "et": "Euro", "en": "Euro", "ru": "\u0415\u0432" }, "vat_number": "EE111111111", "address": "ABC tn 1, 11111, Tallinn, Harju maakond, Eesti Vabariik", "activity": { "type": "NACE", "code": "63.99", "et": "Mujal liigitamata infoalane tegevus", "en": "Other information service activities n.e.c.", "ru": "\u041f\u0440\u043e\u0447\u0438" }, "country": { "type": "RIIGID", "code": "EST", "et": "Eesti", "en": "Estonia", "ru": "\u042d\u0441" } }, "old_names": [ "aktsiaselts ABCD", "Aktsiaselts ABC" ], "contacts_data": [ { "type": "SIDEVAH", "code": "ADDRESS", "et": "Aadress", "en": "Address", "ru": "\u0410\u0434\u0440\u0435\u0441", "content": "ABC tn 1, 11111, Tallinn, Harju maakond, Eesti Vabariik" }, { "type": "SIDEVAH", "code": "WWW", "et": "WWW aadress", "en": "Internet address (www)", "ru": "\u0421\u0430\u0439\u0442 (www)", "content": "www.abc.ee" }, { "type": "SIDEVAH", "code": "EMAIL", "et": "Elektronposti aadress", "en": "E-mail address", "ru": "\u0415-\u043c\u0435", "content": "info@abc.ee" }, { "type": "SIDEVAH", "code": "TEL", "et": "Telefon", "en": "Telephone", "ru": "\u0422\u0435\u043b", "content": "+372 111 1111" } ], "payment_remarks": [ { "source_name": "Intrum Eesti", "source_url": "http:\/\/www.intrum.com\/", "area": {}, "status": { "type": "JULIANUS_STATUS", "code": "\u041a", "et": "Lahendatud", "en": "Resolved", "ru": "\u0420\u0435" }, "amount": "1000.00", "active": false, "claimant": "Intrum Justitia", "start_date": "2015-12-07", "end_date": "2019-07-09", "last_seen": "2019-07-16" } ], "tax_arrears_current": [ { "amount": "1234.00", "scheduled": "1234.00", "disputed": true, "intress": "0.00", "total": 1234, "from": "2015-05-20", "num_of_declarations": null } ], "tax_arrears_history": [ { "label": "May 2019", "year": "2019", "month": "5", "amount": 1234, "scheduled": 1234, "disputed": 0, "intress": 0, "total": 1234, "from": "2015-05-20", "num_of_declarations": 0, "num_of_cases": 1 } ], "enforcement_notices": [ { "debtor": { "type": "ATA_DEBTOR_TYPE", "code": "J", "et": "Juriidiline isik", "en": "Legal person", "ru": "\u042e\u0440\u0438" }, "debtor_name": "ABC O\u00dc", "claimant": { "type": "ATA_CLAIMANT", "code": "MUUD", "et": "M\u00e4\u00e4ramata", "en": "Unspecified", "ru": "\u041d\u0435 \u0443" }, "action": {}, "code": "12110311", "birth_date": null, "amount": "250.30", "created_at": "2019-06-17", "checked_at": "2019-06-19" } ], "court_decisions_on_debt": [ { "debtor_type": { "type": "ATA_DEBTOR_TYPE", "code": "J", "et": "Juriidiline isik", "en": "Legal person", "ru": "\u042e\u0440\u0438" }, "debtor_name": "ABC O\u00dc", "claimant": { "type": "ATA_CLAIMANT", "code": "MUUD", "et": "M\u00e4\u00e4ramata", "en": "Unspecified", "ru": "\u041d\u0435 \u0443" }, "action": { "type": "ATA_ACTION", "code": "Makseettepanek", "et": "Makseettepanek", "en": "Payment proposal", "ru": "\u041f\u0440\u0435" }, "code": "12111611", "birth_date": null, "amount": "2539.47", "created_at": "2019-06-17" } ], "persons_on_card": [ { "role": { "type": "ISIKROLLID", "code": "JUHL", "et": "Juhatuse liige", "en": "Management board member", "ru": "\u0427\u043b\u0435\u043d" }, "start_date": "2009-05-11", "end_date": null, "created_at": "2018-01-12 20:59:30", "updated_at": "2018-07-07 14:53:48", "active": true, "on_card": true, "code": "11111111111", "person_birth_date": "1966-01-01", "person_gener": "M", "country": { "type": "RIIGID", "code": "EST", "et": "Eesti", "en": "Estonia", "ru": "\u042d\u0441" }, "name": "Karl Karll", "type": { "type": "ISIKTYYPID", "code": "F", "et": "F\u00fc\u00fcsiline isik", "en": "Physical person", "ru": "\u0424\u0438\u0437\u0438" } }, { "role": { "type": "ISIKROLLID", "code": "S", "et": "Aktsion\u00e4r", "en": "Stockholder", "ru": "\u0410\u043a" }, "role_code": "S", "information_source": "NASDAQ andmed", "authority_end_date": null, "start_date": "2017-12-22", "end_date": "2019-05-17", "revision_date": null, "control_source": null, "control_source_code": null, "control_source_date": null, "group": null, "created_at": "2019-07-24 13:19:57", "updated_at": "2019-07-24 13:19:57", "active": false, "on_card": false, "code": "SE-111032-1181", "person_birth_date": null, "person_gener": null, "country": {}, "name": "Esindajakonto: ABC Asset", "type": { "type": "ISIKTYYPID", "code": "J", "et": "Juriidiline isik", "en": "Juridical person", "ru": "\u042e\u0440\u0438" }, "ownership": { "type": "OMANDILIIGID", "code": "L", "et": "Lihtomand", "en": "Simple ownership", "ru": "\u041f\u0440\u043e" }, "share_capital_amount": "11111.00", "share_capital_currency": { "type": "VALUUTAD", "code": "EUR", "et": "Euro", "en": "Euro", "ru": "\u0415\u0432\u0440\u043e" }, "share_capital_percent": "100.00" } ], "normal_rights": [ { "type": "REPRESENTRULESNORMAL", "code": "ASJUHL", "et": "Aktsiaseltsi v\u00f5ib k\u00f5ikide tehingute tegemisel esindada iga juhatuse liige.", "en": "Every member of the Management Board may represent the public limited company in concluding all transactions.", "ru": "\u043e\u043e\u043e\u043e." } ], "specific_rights": [ { "type": "REPRESENTRULESSPECIFIC", "code": "NOCODE", "et": "Some specific right text here.", "en": "Some specific right text here.", "ru": "Some specific right text here." } ], "export_countries": [ { "year": "2014", "countries": [ { "type": "RIIGID", "code": "FIN", "et": "Soome", "en": "Finland", "ru": "\u0424\u0438" }, { "type": "RIIGID", "code": "SWE", "et": "Rootsi", "en": "Sweden", "ru": "\u0428\u0432" }, { "type": "RIIGID", "code": "XEU", "et": "Euroopa Liidu maad", "en": "Europe", "ru": "\u0421\u0442\u0440" }, { "type": "RIIGID", "code": "XEX", "et": "Maad v\u00e4ljaspool Euroopa Liitu", "en": "Countries outside the Europe", "ru": "\u0421\u0442\u0440\u0430\u043d" }, { "type": "RIIGID", "code": "DEN", "et": "Taani", "en": "Denmark", "ru": "\u0414\u0430" } ], "amount": "1111111.00" } ], "activities": [ { "type": "NACE", "code": "63.99", "et": "Mujal liigitamata infoalane tegevus", "en": "Other information service activities n.e.c.", "ru": "\u041f\u0440\u043e\u0447\u0438\u0435 \u0432", "is_main": true, "is_active": true } ], "industrial_average": [ { "annual_year": "2018", "num_companies": "11", "current_assets": "111111.1579", "short_term_liabilities": "11111.0556", "equity": "111111.3421", "liabilities_and_equity": "111111.7632", "net_profit_loss": "11111.3421", "net_sales": "111111.8421", "roa": "11.17981443", "equity_ratio": "88.78426649", "quick_ratio": "9.08571217", "profit_margin": "10.43068585", "revenue_per_emploee": "111111.90788065", "profit_per_emploee": "11111.60897419" }, { "annual_year": "2017", "num_companies": "11", "current_assets": "111111.4348", "short_term_liabilities": "111111.8444", "equity": "111111.6087", "liabilities_and_equity": "111111.5870", "net_profit_loss": "11111.0435", "net_sales": "111111.4348", "roa": "11.43606415", "equity_ratio": "77.77071042", "quick_ratio": "4.57482378", "profit_margin": "9.84633622", "revenue_per_emploee": "111111.54428286", "profit_per_emploee": "11111.70495714" } ], "financial_statement": { "analysis": [ { "date": "2018-12-31;2017-12-31", "value": "315036;254359", "code": "CashAndCashEquivalents", "chapter_code": "F01", "chapter": { "type": "CHAPTER", "code": "F01", "et": "Bilanss", "en": "Statement of financial position", "ru": "\u041e\u0442" }, "name": "Cash and cash equivalents", "bold": "no", "depth": 0, "en": "Cash and cash equivalents", "et": "Raha ja raha ekvivalendid", "ru": "\u0414\u0435\u043d" }, { "date": "2018-12-31;2017-12-31", "value": "82060;143252", "code": "ShortTermReceivablesAndPrepayments", "chapter_code": "F01", "chapter": { "type": "CHAPTER", "code": "F01", "et": "Bilanss", "en": "Statement of financial position", "ru": "\u041e\u0442\u0447" }, "name": "Short term receivables and prepayments", "bold": "no", "depth": 0, "en": "Short term receivables and prepayments", "et": "L\u00fchiajalised n\u00f5uded ja ettemaksed", "ru": "\u0414\u0435\u0431\u0438" }, { "date": "2018-12-31;2017-12-31", "value": "1700716;1741065", "code": "Revenue", "chapter_code": "F04", "chapter": { "type": "CHAPTER", "code": "F04", "et": "Kasumiaruande andmed (skeem1)", "en": "Income statement (scheme1)", "ru": "\u041e\u0442\u0447\u0451" }, "name": "Revenue", "bold": "no", "depth": 0, "en": "Revenue", "et": "M\u00fc\u00fcgitulu", "ru": "\u0414\u043e\u0445" }, { "date": "2018-12-31;2017-12-31", "value": "5326;1280", "code": "OtherIncome", "chapter_code": "F04", "chapter": { "type": "CHAPTER", "code": "F04", "et": "Kasumiaruande andmed (skeem1)", "en": "Income statement (scheme1)", "ru": "\u041e\u0442\u0447\u0451" }, "name": "Other income", "bold": "no", "depth": 0, "en": "Other income", "et": "Muud \u00e4ritulud", "ru": "\u041f\u0440\u043e" }, { "date": "2018-12-31;2017-12-31", "value": "33723;24095", "code": "DepreciationAndImpairmentLossReversalNeg", "chapter_code": "F05", "chapter": { "type": "CHAPTER", "code": "F05", "et": "Rahavoogude aruanne (kaudne meetod)", "en": "Statement of cash flows (indirect method)", "ru": "\u041e\u0442\u0447\u0435\u0442" }, "name": "Depreciation and impairment loss (reversal)", "bold": "no", "depth": 0, "en": "Depreciation and impairment loss (reversal)", "et": "P\u00f5hivarade kulum ja v\u00e4\u00e4rtuse langus", "ru": "\u0410\u043c\u043e\u0440\u0442\u0438" }, { "date": "2018-12-31;2017-12-31", "value": "-206;0", "code": "ProfitLossFromSaleOfNonCurrentAssets", "chapter_code": "F05", "chapter": { "type": "CHAPTER", "code": "F05", "et": "Rahavoogude aruanne (kaudne meetod)", "en": "Statement of cash flows (indirect method)", "ru": "\u041e\u0442\u0447\u0435\u0442" }, "name": "Profit (loss) from sale of non-current assets", "bold": "no", "depth": 0, "en": "Profit (loss) from sale of non-current assets", "et": "Kasum (kahjum) p\u00f5hivarade m\u00fc\u00fcgist", "ru": "\u041f\u0440\u0438\u0431\u044b\u043b" }, { "date": "2018-12-31;2017-12-31", "value": "-21439;-31688", "code": "WageAndSalaryExpense", "chapter_code": "F21", "chapter": { "type": "CHAPTER", "code": "F21", "et": "T\u00f6\u00f6j\u00f5ukulude andmed", "en": "Labor expense", "ru": "\u0420\u0430\u0441\u0445\u043e" }, "name": "Wage and salary expense", "bold": "no", "depth": 0, "en": "Wage and salary expense", "et": "Palgakulu", "ru": "\u0420\u0430\u0441" }, { "date": "2018-12-31;2017-12-31", "value": "64;57", "code": "AverageNumberOfEmployeesInFullTimeEquivalentUnits", "chapter_code": "F21", "chapter": { "type": "CHAPTER", "code": "F21", "et": "T\u00f6\u00f6j\u00f5ukulude andmed", "en": "Labor expense", "ru": "\u0420\u0430\u0441\u0445\u043e" }, "name": "Average number of employees in full time equivalent units", "bold": "no", "depth": 0, "en": "Average number of employees in full time equivalent units", "et": "T\u00f6\u00f6tajate keskmine arv taandatuna t\u00e4ist\u00f6\u00f6ajale", "ru": "\u0421\u0440\u0435\u0434\u043d\u0435\u0435 \u0447\u0438\u0441\u043b" }, { "date": "2018-12-31;2017-12-31", "value": "-680;-704", "code": "MiscellaneousOperatingExpensesTrainingExpense", "chapter_code": "F22", "chapter": { "type": "CHAPTER", "code": "F22", "et": "Mitmesuguste tegevuskulude andmed", "en": "Miscellaneous Operating Expenses", "ru": "\u041f\u0440\u043e\u0447\u0438" }, "name": "Training expense", "bold": "no", "depth": 0, "en": "Training expense", "et": "Koolituskulud", "ru": "\u0421\u0442" } ], "attachment": "https:\\", "annual_year": "2018", "period_start": "2017-12-31", "period_end": "2018-12-31" }, "financial_information": [ { "annual_year": "2018", "net_sales": "1111111", "net_sales_trend": -1.1111119202744, "net_profit_loss": "1111", "net_profit_loss_trend": 0, "total_profit_loss": "1111", "total_profit_loss_trend": 0, "current_assets": "1111111", "current_assets_trend": -1.1111116426306, "equity": "1111111", "equity_trend": 0.11118381793394, "short_term_liabilities": "111111", "short_term_liabilities_trend": -1.111101802143, "non_current_assets": "111111", "non_current_assets_trend": -1.1111685500713, "non_current_liabilities": "11111", "non_current_liabilities_trend": 0, "liabilities_and_equity": "1111111", "liabilities_and_equity_trend": -1.1111256593857, "net_sales_consolidated": null, "net_sales_consolidated_trend": 0, "net_profit_loss_consolidated": null, "net_profit_loss_consolidated_trend": 0, "employees": "11", "employees_trend": 1.111101754386, "employees_consolidated": null, "employees_consolidated_trend": 0, "current_assets_consolidated": null, "current_assets_consolidated_trend": 0, "equity_consolidated": null, "equity_consolidated_trend": 0, "short_term_liabilities_consolidated": null, "short_term_liabilities_consolidated_trend": 0, "liabilities_and_equity_consolidated": null, "liabilities_and_equity_consolidated_trend": 0, "export_revenue": null } ], "financial_rates": [ { "annual_year": "2018", "roa": 0.11114999829452, "equity_ratio": 11.444780834695, "quick_ratio": 1.2596700518251, "profit_margin": 0.33725473644928, "revenue_per_emploee": 11111.1875, "profit_per_emploee": 11.890625 } ], "payment_info": [ { "year": "2019", "quarter": "2", "state_taxes_paid": 111111.91, "labor_taxes_paid": 111111.21, "turnover": 111111.92, "employees": 88 }, { "year": "2019", "quarter": "1", "state_taxes_paid": 111111.94, "labor_taxes_paid": 111111.21, "turnover": 111111.2, "employees": 77 } ], "aaa_rating": { "operation_rating": { "status": { "type": "AAA_RATING", "code": "A-EST", "et": "Toimiv ettev\u00f5te", "en": "Established", "ru": "\u0414\u0435" }, "color": "green", "description": "" }, "background_rating": { "status": { "type": "AAA_RATING", "code": "D-POSI", "et": "Positiivne", "en": "Positive", "ru": "\u041f\u043e" }, "color": "green", "description": "" }, "finance_rating": { "status": { "type": "AAA_RATING", "code": "F-GOOD", "et": "Hea", "en": "Good", "ru": "\u0425\u043e" }, "color": "green", "description": "" }, "atp_rating": { "status": { "type": "AAA_RATING", "code": "A-NONE", "et": "Mittenegatiivne", "en": "Not negative", "ru": "\u041d\u0435" }, "color": "green", "description": "" }, "aaa_rating": { "status": { "type": "AAA_RATING", "code": "AA", "et": "Hea krediidiv\u00f5ime", "en": "Good Creditworthiness", "ru": "\u0425\u043e\u0440" }, "color": "green", "description": "" }, "credit_limit": { "status": { "type": "AAA_RATING", "code": 11111.11, "et": "11111 EUR", "en": "11111 EUR", "ru": "11111 EUR" }, "color": "green", "description": {} } }, "is_consolidated": false } ``` {% endtab %} {% tab title="400 Invalid country code" %} ```javascript { "error": "error", "code": 400, "message": "Only EST country supported in this request" } or { "error": "error", "code": 400, "message": "This report type is not supported" } ``` {% endtab %} {% tab title="401 Invalid token" %} ```javascript { "error": "error", "code": 401, "message": "Token is wrong" } ``` {% endtab %} {% tab title="402 Not enough credit" %} ```javascript { "error": "error", "code": 402, "message": "Monthly requests limit exceeded" } ``` {% endtab %} {% tab title="403 " %} ```javascript { "error": "error", "code": 403, "message": "This request is not allowed for you" } ``` {% endtab %} {% tab title="404 Could not find a company matching this query" %} ```javascript { "error": "error", "code": 404, "message": "No such company" } ``` {% endtab %} {% tab title="409 " %} ```javascript { "error": "error", "code": 409, "message": "Something went wrong" } ``` {% endtab %} {% tab title="422 Validation failed" %} ```javascript { "error": "error", "code": 422, "message": "Schema validation error" } ``` {% endtab %} {% tab title="423 " %} ```javascript { "error": "error", "code": 423, "message": "Locked. Wait for previous request to complete" } ``` {% endtab %} {% tab title="500 " %} ```javascript { "error": "error", "code": 500, "message": "Something went wrong" } ``` {% endtab %} {% endtabs %} # Person credit report TEST request - https\://in.bisnode.ee/rest\_dev/getPersonReportTranslated ## getPersonReportTranslated `POST` `https://in.bisnode.ee/rest/getPersonReportTranslated` **Needed Headers:** Content-type: application/json\ \ Includes various information about a person to evaluate trustworthiness of a person such as:\ `* General information`\ `* Current tax arrears`\ `* Trade bans`\ `* Tags`\ `* Debt collection cases`\ `* Enforcements notices`\ `* Court decisions on debt`\ `* Payment remarks in connected companies`\ `* Court cases`\ `* Immovables ("noimmovables" report type doesn't include this information)`\ `* Bancruptcy process notices`\ \ Example Curl request:\ `curl -X POST -k -H 'Content-type: application/json' -i 'https://in.bisnode.ee/rest/getPersonReportTranslated' --data '{`\ `"token": "0c725874e737c8195de547f67692d8b976726561",`\ `"code": "11111111",`\ `"code_origin": "EST",`\ `"type": "private",`\ `"language": "en"`\ `}'` #### Query Parameters | Name | Type | Description | | ------------ | ------ | -------------------------------------------------------------------------- | | type | string | Type of report. Must be "private" or "noimmovables". Default is "private". | | language | string | 2-letter language code.Must be "en", "et" or "ru". Default is "en". | | token | string | Your 'access token' (API key). | | code | string | Personal code. | | code\_origin | string | 3-letter country code. | {% tabs %} {% tab title="200 " %} ```javascript { "header": { "created_at": "10\/07\/2019 15:04:12", "created_by": "BISNODE ESTONIA AS", "generator_class": "PersonReportCalculator", "generator_version": "v1.0" }, "report": { "pdf": "", "html": "", "created_at": "10\/07\/2019 15:04:12", "type": "private" }, "general": { "id": "111111", "name": "Karl Karll", "code": "11111111111", "code_origin": { "type": "RIIGID", "code": "EST", "et": "Eesti", "en": "Estonia", "ru": "\u042d\u0441\u0442\u043e\u043d\u0438\u044f" }, "birth_date": "1951-06-14", "type": "person", "gender": "M" }, "tax_arrears_current": [ { "amount": 0, "scheduled": 0, "disputed": 0, "intress": 0, "total": 0, "from": null, "num_of_declarations": 0 } ], "trade_ban": [ { "type": { "type": "TRADE_BAN", "code": "trade_ban", "et": "\u00c4rikeeld", "en": "Trade ban", "ru": " \u0417\u0430\u043f\u0440\u0435\u0442 \u043d\u0430 \u0442\u043e\u0440\u0433\u043e\u0432\u043b\u044e" }, "status": { "type": "TRADE_BAN", "code": "IN_FORCE", "et": "J\u00f5us", "en": "In force", "ru": "\u0412 \u0441\u0438\u043b\u0435" }, "term_of_validity": "Pankrotimenetluse l\u00f5ppemiseni", "scope": "Osaline 01.01.2017 Harju Maakohtu m\u00e4\u00e4rusega lubatud Karl Karll (isikukood 11111111111) tegutseda kuni pankrotimenetluse l\u00f5puni EBS Juhtimiskoolituse Keskus O\u00dc (registrikood 11111111), Aktsiaseltsi Estonian Business School Group (registrikood 11111111) ja Eesti Ol\u00fcmpiakomitee (registrikood 11111111) T\u00e4itevkomitee juhatuse liikmena.", "start_date": "2015-03-13", "end_date": "2019-06-17" } ], "tags": [ { "title": "Tankist", "description": "Marked as tankist", "slug": "tankist" } ], "debt_collection_cases": [ { "id": "150618", "source_id": "18", "company_id": null, "claimant": "Julianus Inkasso O\u00dc", "reg_code": "39103274915", "start_date": "2018-03-12", "end_date": null, "area": { "type": "JULIANUS_AREA", "code": "A4", "et": "Muud finantsteenused", "en": "Other financial services", "ru": "\u0414\u0440\u0443\u0433\u0438\u0435 \u0444\u0438\u043d\u0430\u043d\u0441\u043e\u0432\u044b\u0435 \u0443\u0441\u043b\u0443\u0433\u0438" }, "amount": "2232.56", "status": { "type": "JULIANUS_STATUS", "code": "A", "et": "Avalikustatud", "en": "Active", "ru": "\u0410\u043a\u0442\u0438\u0432\u0435\u043d" }, "last_seen": "2019-07-10", "created_at": "2019-07-10 15:12:34", "updated_at": "2019-07-10 15:12:34", "source_name": "Julianus Inkasso O\u00dc", "source_url": "https:\/www.taust.ee", "active": true }, { "id": "150626", "source_id": "18", "company_id": null, "claimant": "IPF Digital Estonia O\u00dc", "reg_code": "39103274915", "start_date": "2014-01-03", "end_date": "2018-03-07", "area": { "type": "JULIANUS_AREA", "code": "A4", "et": "Muud finantsteenused", "en": "Other financial services", "ru": "\u0414\u0440\u0443\u0433\u0438\u0435 \u0444\u0438\u043d\u0430\u043d\u0441\u043e\u0432\u044b\u0435 \u0443\u0441\u043b\u0443\u0433\u0438" }, "amount": "2463.52", "status": { "type": "JULIANUS_STATUS", "code": "\u041a", "et": "Lahendatud", "en": "Resolved", "ru": "\u0420\u0435\u0448\u0435\u043d" }, "last_seen": "2018-03-07", "created_at": "2019-07-10 15:12:34", "updated_at": "2019-07-10 15:12:34", "source_name": "Julianus Inkasso O\u00dc", "source_url": "https:\/www.taust.ee", "active": false } ], "enforcement_notices": [ { "debtor": { "type": "ATA_DEBTOR_TYPE", "code": "F", "et": "F\u00fc\u00fcsiline isik", "en": "Individual", "ru": "\u0424\u0438\u0437\u0438\u0447\u0435\u0441\u043a\u043e\u0435 \u043b\u0438\u0446\u043e" }, "debtor_name": "Karl Karll", "claimant": { "type": "ATA_CLAIMANT", "code": "MUUD", "et": "M\u00e4\u00e4ramata", "en": "Unspecified", "ru": "\u041d\u0435 \u0443\u043a\u0430\u0437\u0430\u043d\u043e" }, "action": {}, "code": "11111111111", "birth_date": null, "amount": "30114.11", "created_at": "2017-09-08", "checked_at": "2017-09-09" } ], "court_decisions_on_debt": [ { "debtor_type": { "type": "ATA_DEBTOR_TYPE", "code": "F", "et": "F\u00fc\u00fcsiline isik", "en": "Individual", "ru": "\u0424\u0438\u0437\u0438\u0447\u0435\u0441\u043a\u043e\u0435 \u043b\u0438\u0446\u043e" }, "debtor_name": "Karl Karll", "claimant": { "type": "ATA_CLAIMANT", "code": "MUUD", "et": "M\u00e4\u00e4ramata", "en": "Unspecified", "ru": "\u041d\u0435 \u0443\u043a\u0430\u0437\u0430\u043d\u043e" }, "action": { "type": "ATA_ACTION", "code": "maksek\u00e4sk", "et": "Maksek\u00e4sk", "en": "Order of payment", "ru": "\u041f\u043b\u0430\u0442\u0435\u0436\u043d\u043e\u0435 \u043f\u043e\u0440\u0443\u0447\u0435\u043d\u0438\u0435" }, "code": "11111111111", "birth_date": null, "amount": "4856.35", "created_at": "2019-06-10" } ], "payment_remarks_in_connected_companies": [ { "tax_arrears": false, "ata_debts": false, "debt_collection_cases": false, "company_name": "ABC O\u00dc", "reg_code": "11111111", "role": { "type": "ISIKROLLID", "code": "JUHL", "et": "Juhatuse liige", "en": "Management board member", "ru": "\u0427\u043b\u0435\u043d \u043f\u0440\u0430\u0432\u043b\u0435\u043d\u0438\u044f" }, "status": { "type": "LEGAL_STATUS_EST", "code": "A", "et": "Aktiivne", "en": "Active", "ru": "\u0410\u043a\u0442\u0438\u0432\u043d\u044b\u0439" } } ], "court_cases": { "link": "https:\/\/www.riigiteataja.ee\/kohtulahendid\/koik_menetlused.html", "total": 4, "cases": [ { "case_no": "1-02-65442\\3", "start_date": "2009-09-05", "category": "", "resolution_date": "2009-12-13", "type_of_case": { "type": "COURT_CASE", "code": "CC13", "et": "Kriminaalasi", "en": "Criminal case", "ru": "\u0423\u0433\u043e\u043b\u043e\u0432\u043d\u043e\u0435 \u0434\u0435\u043b\u043e" }, "type_of_proceeding": { "type": "COURT_CASE", "code": "CC4", "et": "Kohtu I astme menetlus", "en": "Proceeding of court of first instance", "ru": "\u0421\u0443\u0434\u0435\u0431\u043d\u043e\u0435 \u043f\u0440\u043e\u0438\u0437\u0432\u043e\u0434\u0441\u0442\u0432\u043e I \u0441\u0442\u0435\u043f\u0435\u043d\u0438 " }, "type_of_resolution": { "type": "COURT_CASE", "code": "CC14", "et": "Kohtuotsus", "en": "Court decision", "ru": "\u0421\u0443\u0434\u0435\u0431\u043d\u043e\u0435 \u0440\u0435\u0448\u0435\u043d\u0438\u0435" } }, { "case_no": "1-05-98763\/27", "start_date": "2018-10-31", "category": "Isikuvastased s\u00fc\u00fcteod, Isikuvastased s\u00fc\u00fcteod, Rahvatervisevastased s\u00fc\u00fcteod", "resolution_date": "2019-02-01", "type_of_case": { "type": "COURT_CASE", "code": "CC13", "et": "Kriminaalasi", "en": "Criminal case", "ru": "\u0423\u0433\u043e\u043b\u043e\u0432\u043d\u043e\u0435 \u0434\u0435\u043b\u043e" }, "type_of_proceeding": { "type": "COURT_CASE", "code": "CC4", "et": "Kohtu I astme menetlus", "en": "Proceeding of court of first instance", "ru": "\u0421\u0443\u0434\u0435\u0431\u043d\u043e\u0435 \u043f\u0440\u043e\u0438\u0437\u0432\u043e\u0434\u0441\u0442\u0432\u043e I \u0441\u0442\u0435\u043f\u0435\u043d\u0438 " }, "type_of_resolution": { "type": "COURT_CASE", "code": "CC14", "et": "Kohtuotsus", "en": "Court decision", "ru": "\u0421\u0443\u0434\u0435\u0431\u043d\u043e\u0435 \u0440\u0435\u0448\u0435\u043d\u0438\u0435" } } ] }, "immovables": [ { "immovable_no": "1111", "type": { "type": "IMMOVABLES", "code": "ABCDE02", "et": "Korteriomand", "en": "Apartment ownership", "ru": "\u041a\u0432\u0430\u0440\u0442\u0438\u0440\u043d\u0430\u044f \u0441\u043e\u0431\u0441\u0442\u0432\u0435\u043d\u043d\u043e\u0441\u0442\u044c" }, "cadastral_code": "11111:111:0101", "address": "Pinna tn 31 , Tallinna linnaosa, Tallinn, Harju maakond", "area": "700 m2", "apt_no": "1", "registry_code_of_apartment_association": "11111111", "purpose": { "type": "IMMOVABLES", "code": "ABCD01", "et": "Elamumaa 100%", "en": "Residental land 100%", "ru": "\u0417\u0435\u043c\u043b\u044f \u0434\u043b\u044f \u0436\u0438\u043b\u0438\u0449\u043d\u043e\u0433\u043e \u0441\u0442\u0440\u043e\u0438\u0442\u0435\u043b\u044c\u0441\u0442\u0432\u0430 100%" } } ], "bankruptcy_process_notices": [ { "code": "11111111111", "created_at": "2015-11-08", "message_type": { "type": "BANKRUPTCY", "code": "BA197", "et": "V\u00f5lausaldajate \u00fcldkoosoleku teade", "en": "Notice of the time, place and agenda of a general meeting of creditors", "ru": "\u0423\u0432\u0435\u0434\u043e\u043c\u043b\u0435\u043d\u0438\u0435 \u043e\u0431 \u043e\u0431\u0449\u0435\u043c \u0441\u043e\u0431\u0440\u0430\u043d\u0438\u0438 \u043a\u0440\u0435\u0434\u0438\u0442\u043e\u0440\u043e\u0432" } } ] } ``` {% endtab %} {% tab title="400 Invalid country code" %} ```javascript { "error": "error", "code": 400, "message": "This report type is not supported" } ``` {% endtab %} {% tab title="401 Invalid token" %} ```javascript { "error": "error", "code": 401, "message": "Token is wrong" } ``` {% endtab %} {% tab title="402 Not enough credit" %} ```javascript { "error": "error", "code": 402, "message": "Monthly requests limit exceeded" } ``` {% endtab %} {% tab title="403 " %} ```javascript { "error": "error", "code": 403, "message": "This request is not allowed for you" } ``` {% endtab %} {% tab title="404 Could not find a person matching this query" %} ```javascript { "error": "error", "code": 404, "message": "No such person" } ``` {% endtab %} {% tab title="409 " %} ```javascript { "error": "error", "code": 409, "message": "Something went wrong" } ``` {% endtab %} {% tab title="422 Validation failed" %} ```javascript { "error": "error", "code": 422, "message": "Schema validation error" } ``` {% endtab %} {% tab title="423 " %} ```javascript { "error": "error", "code": 423, "message": "Locked. Wait for previous request to complete" } ``` {% endtab %} {% tab title="500 " %} ```javascript { "error": "error", "code": 500, "message": "Internal server error" } ``` {% endtab %} {% endtabs %} # getPersonInformation TEST request - https\://in.bisnode.ee/rest\_dev/getPersonInformation ## getPersonInformation `POST` `https://in.bisnode.ee/rest/getPersonInformation` **Needed headers:** Content-type: application/json\ \ This endpoint allows you to get general person information such as:\ `* Personal code`\ `* First name and last name`\ `* Previous first name and last name (if exist)`\ `* Death date (if exists)`\ `* Personal address`\ \ Example Curl request:\ `curl -X POST -k -H 'Content-type: application/json' -i 'https://in.bisnode.ee/rest/getPersonInformation' --data '{`\ `"token": "0c4386e0983540c97u8930de8570820f967827",`\ `"code": "12345678900",`\ `"language": "en"`\ `}'` #### Query Parameters | Name | Type | Description | | -------- | ------ | -------------------------------------------------------------------- | | language | string | 2-letter language code. Must be "en", "et" or "ru". Default is "en". | | token | string | Your 'access token' (API key). | | code | string | Personal code. | {% tabs %} {% tab title="200 Response successfully retrieved" %} ```javascript { "personal_code": "12345678900", "last_name": "Karllson", "first_name": "Karl", "ex_last_name": "Blumberg", "ex_first_name": "Karl", "death_date": null, "address": "Harju maakond, Tallinn, Lasnamäe linnaosa, Oksa 1-15" } ``` {% endtab %} {% tab title="400 Invalid personal code" %} ```javascript { "error": "error", "code": 400, "message": "Code is mandatory" } ``` {% endtab %} {% tab title="401 Invalid token" %} ```javascript { "error": "error", "code": 401, "message": "Token is wrong" } ``` {% endtab %} {% tab title="402 Not enough credit" %} ```javascript { "error": "error", "code": 402, "message": "Monthly requests limit exceeded" } ``` {% endtab %} {% tab title="403 " %} ```javascript { "error": "error", "code": 403, "message": "This request is not allowed for you" } ``` {% endtab %} {% tab title="404 Could not find a person matching this query" %} ```javascript { "error": "error", "code": 404, "message": "No such person" } ``` {% endtab %} {% tab title="409 " %} ```javascript { "error": "error", "code": 409, "message": "Something went wrong" } ``` {% endtab %} {% tab title="423 " %} ```javascript { "error": "error", "code": 423, "message": "Locked. Wait for previous request to complete" } ``` {% endtab %} {% tab title="500 " %} ```javascript { "error": "error", "code": 500, "message": "Internal Server Error" } ``` {% endtab %} {% endtabs %} # Person code validator TEST request - https\://in.bisnode.ee/rest\_dev/getPersonCodeValidator ## getPersonCodeValidator `POST` `https://in.bisnode.ee/rest/getPersonCodeValidator` **Needed headers:** Content-type: application/json\ \ This endpoint allows you to validate a personal code and extract personal information from it such as:\ `* Country`\ ``empty if Estonia or Lithuania (identical codes) - country can`t be detected``\ `Latvia (LVA)`\ `Finland (FIN)`\ `* Birthday` \ ``empty if Latvia - can`t be detected``\ `* Gender:`\ `Male (M)`\ `Female (F)`\ If response is **empty array \[ ]** - this means your **code is invalid**.\ \ Example Curl request:\ `curl -X POST -k -H 'Content-type: application/json' -i 'https://in.bisnode.ee/rest/getPersonCodeValidator' --data '{`\ `"token": "0c43592834623946u464e963570304596",`\ `"code": "11111111111"`\ `}'` #### Query Parameters | Name | Type | Description | | ---- | ------ | -------------- | | code | string | Personal code. | {% tabs %} {% tab title="200 Country = 'EST' or 'LTU' (lines 1-4 in example response) Country = 'LVA' (lines 6-9) Country = 'FIN' (lines 11-15) 'not valid code' (returns empty array \[ ] , line 17) see example responses below:" %} ```javascript { "gender": "F", "birthdate": "1990-06-15" } or { "birthdate": "1980-10-03", "country": "LVA" } or { "gender": "F", "birthdate": "1977-04-26", "country": "FIN" } or [] ``` {% endtab %} {% tab title="400 Invalid country code" %} ```javascript { "error": "error", "code": 400, "message": "Code is mandatory" } ``` {% endtab %} {% tab title="401 Invalid token" %} ```javascript { "error": "error", "code": 401, "message": "Token is wrong" } ``` {% endtab %} {% tab title="402 Not enough credit" %} ```javascript { "error": "error", "code": 402, "message": "Monthly requests limit exceeded" } ``` {% endtab %} {% tab title="403 " %} ```javascript { "error": "error", "code": 403, "message": "This request is not allowed for you" } ``` {% endtab %} {% tab title="409 " %} ```javascript { "error": "error", "code": 409, "message": "Something went wrong" } ``` {% endtab %} {% tab title="422 Validation failed" %} ```javascript { "error": "error", "code": 422, "message": "Schema validation error" } ``` {% endtab %} {% tab title="423 " %} ```javascript { "error": "error", "code": 423, "message": "Locked. Wait for previous request to complete" } ``` {% endtab %} {% tab title="500 " %} ```javascript { "error": "error", "code": 500, "message": "Internal Server Error" } ``` {% endtab %} {% endtabs %} # BBC API European company data available through a single API Bisnode Business Contacts (BBC) provides you with one integration access to unique European Company data in 21 countries. Integration with our API will ensure updated customer data in all your business systems. That creates an opportunity to improve your sales process and customer experience throughout the customer journey. [Visit BBC API reference page.](https://wso2api.bisnode.com/store/apis/info?name=BBC\&version=v2\&provider=bbc-team%40bisnode.com#endpoint_reference_anc) # getProfile Get user profile by email/password. ## getProfile `POST` `https://in.bisnode.ee/rest/getProfile` Example cURL command\ `curl -X POST -k -H 'Content-type: application/json' -i 'https://in.bisnode.ee/rest/getProfile' --data '{"email":"example@bisnode.ee","pass":"11111111111"}'` #### Request Body | Name | Type | Description | | ----- | ------ | ---------------- | | email | string | Email of account | | pass | string | Password | {% tabs %} {% tab title="200 User found" %} ``` { "email": "example@bisnode.ee", "name": "Firstname Lastname", "company_name": "Bisnode AS", "reg_code": "10117826", "address": "Pronksi 12, Tallinn 10117", "role": "list,of,roles", "token": "xxxxxxxxxxxxxxx", "created": "2014-01-01 12:00:00" } ``` {% endtab %} {% tab title="404 User not found" %} ``` { "error": "error", "code": 404, "message": "No such user" } ``` {% endtab %} {% endtabs %} This request can be used for authorizarion, then you can store `token` parameter from response to the session for later usage in other requests. # getLimits Get limits ## getLimits `POST` `https://in.bisnode.ee/rest/getLimits` Get limits assigned to a current user\ \ Example cURL request:\ `curl -X POST -k -H 'Content-type: application/json' -i 'https://in.bisnode.ee/rest/getLimits' --data '{"token":"0c43592834623946u464e963570304596"}'` #### Path Parameters | Name | Type | Description | | ----- | ------ | -------------- | | token | string | Your API token | {% tabs %} {% tab title="200 If limits are set, you'll receive list of how many requests you can do." %} ``` { "action:searchCompany":1000, "action:getAnnualReport":50 } ``` {% endtab %} {% tab title="400 If no limits for account is set, you've receive this" %} ``` { "error": "error", "code": 400, "message": "Limits has not been set up" } ``` {% endtab %} {% endtabs %}