https://in.bisnode.ee/rest/getAnnualReport

Buy annual report and perform analysis. From PDF and XBRL files we extract finance statements,
translate, sort and normalize into unique form, so any report will have same structure, units and facts order.

Some PDF is scanned and can't be analyzed. In this case you will receive results later by email.

Request

You have to perform POST request with JSON-encoded parameters:

  • token - access token (required)
  • country - country code, currently only EST is supported (optional, default EST)
  • reg_code - registration number of company (optional, default 10117826 Bisnode)
  • doc_type - type of document A for PDF, X for XBRL, D for Digidoc
  • annual_year - year of annual report
  • customer - if you're reseller, you can add a note about your customer here. Used only in log file, you can search and filter log by this parameter (optional)
  • language - language of results en,et or ru (optional, default en)

Call listAnnualReport for necessary country, reg_code, doc_type and annual_year values.

Example:

{
	"token": "a395281bf96bcd8b4cd2b8b54b918d15",
	"country": "EST",
	"reg_code": "10117826",
	"doc_type": "A",
	"annual_year": "2016"
}

Response

Parts of response:

  • general - general company information
  • attachment - url for downloading original document
  • doc_type - type of document A for PDF, X for XBRL, D for Digidoc
  • annual_year - year of annual report
  • analysis - document analysis is array of facts with date, value, chapter, code, name, note, bold and depth parameters.
  • period_start - start of annual report period
  • period_end - end of annual report period
  • registered_at - date of document registered in Ariregister

Example:

{
  "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": "Endla tn 15, 10122, Kesklinna linnaosa, 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\/103208\/7b274d6b4dbe4c4c150176cc808fe97e\/10117826_9004420435_A_2016.pdf",
  "annual_year": "2016",
  "analysis": [
    {
      "chapter_code": "F01",
      "code": "StatementOfFinancialPositionAbstract",
      "date": "2016-12-31;2016-01-01",
      "value": ";",
      "chapter": "Statement of financial position",
      "name": "Statement of financial position",
      "bold": "no",
      "depth": 0
    },
    {
      "chapter_code": "F01",
      "code": "AssetsAbstract",
      "date": "2016-12-31;2016-01-01",
      "value": " ; ",
      "chapter": "Statement of financial position",
      "name": "Assets",
      "bold": "no",
      "depth": 0
    },
    {
      "chapter_code": "F01",
      "code": "NonCurrentAssetsAbstract",
      "date": "2016-12-31;2016-01-01",
      "value": " ; ",
      "chapter": "Statement of financial position",
      "name": "Non-current assets",
      "bold": "no",
      "depth": 0
    },
    {
      "chapter_code": "F01",
      "code": "IntangibleAssets",
      "date": "2016-12-31;2016-01-01",
      "value": "237760;79282",
      "chapter": "Statement of financial position",
      "name": "Intangible assests",
      "bold": "no",
      "depth": 0
    },
    {
      "chapter_code": "F01",
      "code": "NonCurrentAssets",
      "date": "2016-12-31;2016-01-01",
      "value": "282507;226653",
      "chapter": "Statement of financial position",
      "name": "Total non-current assets",
      "bold": "no",
      "depth": 0
    },
    {
      "chapter_code": "F01",
      "code": "Assets",
      "date": "2016-12-31;2016-01-01",
      "value": "1793884;1722674",
      "chapter": "Statement of financial position",
      "name": "Total assets",
      "bold": "no",
      "depth": 0
    },
    {
      "chapter_code": "F01",
      "code": "LiabilitiesAndEquityAbstract",
      "date": "2016-12-31;2016-01-01",
      "value": " ; ",
      "chapter": "Statement of financial position",
      "name": "Liabilities and equity",
      "bold": "no",
      "depth": 0
    },
    {
      "chapter_code": "F01",
      "code": "EquityAbstract",
      "date": "2016-12-31;2016-01-01",
      "value": " ; ",
      "chapter": "Statement of financial position",
      "name": "Equity",
      "bold": "no",
      "depth": 0
    },
    {
      "chapter_code": "F01",
      "code": "IssuedCapital2",
      "date": "2016-12-31;2016-01-01",
      "value": "25560;25560",
      "chapter": "Statement of financial position",
      "name": "Issued capital",
      "bold": "no",
      "depth": 0
    },
    {
      "chapter_code": "F01",
      "code": "StatutoryReservCapital",
      "date": "2016-12-31;2016-01-01",
      "value": "2556;2556",
      "chapter": "Statement of financial position",
      "name": "Statutory reserv capital",
      "bold": "no",
      "depth": 0
    },
    {
      "chapter_code": "F01",
      "code": "RetainedEarningsLoss",
      "date": "2016-12-31;2016-01-01",
      "value": "1494503;1331308",
      "chapter": "Statement of financial position",
      "name": "Retained earnings (loss)",
      "bold": "no",
      "depth": 0
    },
    {
      "chapter_code": "F01",
      "code": "AnnualPeriodProfitLoss",
      "date": "2016-12-31;2016-01-01",
      "value": "43478;163195",
      "chapter": "Statement of financial position",
      "name": "Annual period profit (loss)",
      "bold": "no",
      "depth": 0
    },
    {
      "chapter_code": "F01",
      "code": "Equity",
      "date": "2016-12-31;2016-01-01",
      "value": "1566097;1522619",
      "chapter": "Statement of financial position",
      "name": "Total equity",
      "bold": "no",
      "depth": 0
    },
    {
      "chapter_code": "F01",
      "code": "LiabilitiesAndEquity",
      "date": "2016-12-31;2016-01-01",
      "value": "1793884;1722674",
      "chapter": "Statement of financial position",
      "name": "Total liabilities and equity",
      "bold": "no",
      "depth": 0
    },
    {
      "chapter_code": "F17",
      "code": "IncomeStatementAbstract",
      "date": "2016-12-31;2016-01-01",
      "value": ";",
      "chapter": "Income statement",
      "name": "Income statement",
      "bold": "no",
      "depth": 0
    },
    {
      "chapter_code": "F17",
      "code": "Revenue",
      "date": "2016-12-31;2016-01-01",
      "value": "1355363;1352617",
      "chapter": "Income statement",
      "name": "Revenue",
      "bold": "no",
      "depth": 0
    },
    {
      "chapter_code": "F17",
      "code": "OtherIncome",
      "date": "2016-12-31;2016-01-01",
      "value": "1305;0",
      "chapter": "Income statement",
      "name": "Other income",
      "bold": "no",
      "depth": 0
    },
    {
      "chapter_code": "F17",
      "code": "RawMaterialsAndConsumablesUsed",
      "date": "2016-12-31;2016-01-01",
      "value": "-64851;-66476",
      "chapter": "Income statement",
      "name": "Raw materials and consumables used",
      "bold": "no",
      "depth": 0
    },
    {
      "chapter_code": "F17",
      "code": "OtherOperatingExpense",
      "date": "2016-12-31;2016-01-01",
      "value": "-131770;-81848",
      "chapter": "Income statement",
      "name": "Other operating expense",
      "bold": "no",
      "depth": 0
    },
    {
      "chapter_code": "F17",
      "code": "EmployeeExpense",
      "date": "2016-12-31;2016-01-01",
      "value": "-1020619;-996577",
      "chapter": "Income statement",
      "name": "Employee expense",
      "bold": "no",
      "depth": 0
    },
    {
      "chapter_code": "F17",
      "code": "DepreciationAndImpairmentLossReversal",
      "date": "2016-12-31;2016-01-01",
      "value": "-82251;-40737",
      "chapter": "Income statement",
      "name": "Depreciation and impairment loss (reversal)",
      "bold": "no",
      "depth": 0
    },
    {
      "chapter_code": "F17",
      "code": "OtherExpense",
      "date": "2016-12-31;2016-01-01",
      "value": "-15025;-4728",
      "chapter": "Income statement",
      "name": "Other expense",
      "bold": "no",
      "depth": 0
    },
    {
      "chapter_code": "F17",
      "code": "TotalProfitLoss",
      "date": "2016-12-31;2016-01-01",
      "value": "42152;162251",
      "chapter": "Income statement",
      "name": "Profit (loss)",
      "bold": "no",
      "depth": 0
    },
    {
      "chapter_code": "F17",
      "code": "IncomeStatementFinancialServicesProviderInterestIncome",
      "date": "2016-12-31;2016-01-01",
      "value": "1768;1386",
      "chapter": "Income statement",
      "name": "Interest income",
      "bold": "no",
      "depth": 0
    },
    {
      "chapter_code": "F17",
      "code": "InterestExpenses",
      "date": "2016-12-31;2016-01-01",
      "value": "-442;-442",
      "chapter": "Income statement",
      "name": "Interest expenses",
      "bold": "no",
      "depth": 0
    },
    {
      "chapter_code": "F17",
      "code": "TotalProfitLossBeforeTax",
      "date": "2016-12-31;2016-01-01",
      "value": "43478;163195",
      "chapter": "Income statement",
      "name": "Profit (loss) before tax",
      "bold": "no",
      "depth": 0
    },
    {
      "chapter_code": "F17",
      "code": "TotalAnnualPeriodProfitLoss",
      "date": "2016-12-31;2016-01-01",
      "value": "43478;163195",
      "chapter": "Income statement",
      "name": "Annual period profit (loss)",
      "bold": "no",
      "depth": 0
    },
    {
      "chapter_code": "F18",
      "code": "StatementOfCashFlowsAbstract",
      "date": "2016-12-31;2016-01-01",
      "value": ";",
      "chapter": "Statement of cash flows",
      "name": "Statement of cash flows",
      "bold": "no",
      "depth": 0
    },
    {
      "chapter_code": "F18",
      "code": "CashFlowsFromOperatingActivitiesAbstract",
      "date": "2016-12-31;2016-01-01",
      "value": " ; ",
      "chapter": "Statement of cash flows",
      "name": "Cash flows from operating activities",
      "bold": "no",
      "depth": 0
    },
    {
      "chapter_code": "F18",
      "code": "AdjustmentsAbstract",
      "date": "2016-12-31;2016-01-01",
      "value": " ; ",
      "chapter": "Statement of cash flows",
      "name": "Adjustments",
      "bold": "no",
      "depth": 0
    },
    {
      "chapter_code": "F18",
      "code": "DepreciationAndImpairmentLossReversalNeg",
      "date": "2016-12-31;2016-01-01",
      "value": "82251;40737",
      "chapter": "Statement of cash flows",
      "name": "Depreciation and impairment loss (reversal)",
      "bold": "no",
      "depth": 0
    },
    {
      "chapter_code": "F18",
      "code": "Adjustments",
      "date": "2016-12-31;2016-01-01",
      "value": "82251;40737",
      "chapter": "Statement of cash flows",
      "name": "Total adjustments",
      "bold": "no",
      "depth": 0
    },
    {
      "chapter_code": "F18",
      "code": "ChangesInReceivablesAndPrepaymentsRelatedToOperatingActivities",
      "date": "2016-12-31;2016-01-01",
      "value": "-1281;-8613",
      "chapter": "Statement of cash flows",
      "name": "Changes in receivables and prepayments related to operating activities",
      "bold": "no",
      "depth": 0
    },
    {
      "chapter_code": "F18",
      "code": "ChangesInPayablesAndPrepaymentsRelatedToOperatingActivities",
      "date": "2016-12-31;2016-01-01",
      "value": "29595;52257",
      "chapter": "Statement of cash flows",
      "name": "Changes in payables and prepayments related to operating activities",
      "bold": "no",
      "depth": 0
    },
    {
      "chapter_code": "F18",
      "code": "OperatingActivitiesIntrestPaid",
      "date": "2016-12-31;2016-01-01",
      "value": "-442;-442",
      "chapter": "Statement of cash flows",
      "name": "Interest paid",
      "bold": "no",
      "depth": 0
    },
    {
      "chapter_code": "F18",
      "code": "CashFlowsFromOperatingActivities",
      "date": "2016-12-31;2016-01-01",
      "value": "152275;246190",
      "chapter": "Statement of cash flows",
      "name": "Total cash flows from operating activities",
      "bold": "no",
      "depth": 0
    },
    {
      "chapter_code": "F18",
      "code": "CashFlowsFromInvestingActivitiesAbstract",
      "date": "2016-12-31;2016-01-01",
      "value": " ; ",
      "chapter": "Statement of cash flows",
      "name": "Cash flows from investing activities",
      "bold": "no",
      "depth": 0
    },
    {
      "chapter_code": "F18",
      "code": "InvestingActivitiesPurchaseOfPropertyPlantAndEquipmentAndIntangibleAssets",
      "date": "2016-12-31;2016-01-01",
      "value": "-238313;-61185",
      "chapter": "Statement of cash flows",
      "name": "Purchase of property, plant and equipment and intangible assets",
      "bold": "no",
      "depth": 0
    },
    {
      "chapter_code": "F18",
      "code": "InvestingActivitiesIntrestReceived",
      "date": "2016-12-31;2016-01-01",
      "value": "994;1386",
      "chapter": "Statement of cash flows",
      "name": "Interest received",
      "bold": "no",
      "depth": 0
    },
    {
      "chapter_code": "F18",
      "code": "CashFlowsFromInvestingActivities",
      "date": "2016-12-31;2016-01-01",
      "value": "-237319;-59799",
      "chapter": "Statement of cash flows",
      "name": "Total cash flows from investing activities",
      "bold": "no",
      "depth": 0
    },
    {
      "chapter_code": "F18",
      "code": "CashFlowsFromFinancingActivitiesAbstract",
      "date": "2016-12-31;2016-01-01",
      "value": " ; ",
      "chapter": "Statement of cash flows",
      "name": "Cash flows from financing activities",
      "bold": "no",
      "depth": 0
    },
    {
      "chapter_code": "F18",
      "code": "FinancingActivitiesProceedsFromFinanceLease",
      "date": "2016-12-31;2016-01-01",
      "value": "-1863;-1863",
      "chapter": "Statement of cash flows",
      "name": "Proceeds from finance lease",
      "bold": "no",
      "depth": 0
    },
    {
      "chapter_code": "F18",
      "code": "CashFlowsFromFinancingActivities",
      "date": "2016-12-31;2016-01-01",
      "value": "-1863;-1863",
      "chapter": "Statement of cash flows",
      "name": "Total cash flows from financing activities",
      "bold": "no",
      "depth": 0
    },
    {
      "chapter_code": "F18",
      "code": "CashFlows",
      "date": "2016-12-31;2016-01-01",
      "value": "-86907;184528",
      "chapter": "Statement of cash flows",
      "name": "Total cash flows",
      "bold": "no",
      "depth": 0
    },
    {
      "chapter_code": "F18",
      "code": "CashAndCashEquivalentsAtBeginningOfPeriod",
      "date": "2016-12-31;2016-01-01",
      "value": "1349383;1164855",
      "chapter": "Statement of cash flows",
      "name": "Cash and cash equivalents at beginning of period",
      "bold": "no",
      "depth": 0
    },
    {
      "chapter_code": "F18",
      "code": "ChangeInCashAndCashEquivalents",
      "date": "2016-12-31;2016-01-01",
      "value": "-86907;184528",
      "chapter": "Statement of cash flows",
      "name": "Change in cash and cash equivalents",
      "bold": "no",
      "depth": 0
    },
    {
      "chapter_code": "F18",
      "code": "CashAndCashEquivalentsAtEndOfPeriod",
      "date": "2016-12-31;2016-01-01",
      "value": "1262476;1349383",
      "chapter": "Statement of cash flows",
      "name": "Cash and cash equivalents at end of period",
      "bold": "no",
      "depth": 0
    },
    {
      "chapter_code": "F22",
      "code": "MiscellaneousOperatingExpensesTrainingExpense",
      "date": "2016-12-31;2016-01-01",
      "value": "-3395;-754",
      "chapter": "Miscellaneous Operating Expenses",
      "name": "Miscellaneous operating expenses training expense",
      "bold": "no",
      "depth": 0
    },
    {
      "chapter_code": "F21",
      "code": "WageAndSalaryExpense",
      "date": "2016-12-31;2016-01-01",
      "value": "-741153;-734138",
      "chapter": "Labor expense",
      "name": "Wage and salary expense",
      "bold": "no",
      "depth": 0
    },
    {
      "chapter_code": "F21",
      "code": "LaborExpense",
      "date": "2016-12-31;2016-01-01",
      "value": "-1020619;-996577",
      "chapter": "Labor expense"
    },
    {
      "chapter_code": "F21",
      "code": "AverageNumberOfEmployeesInFullTimeEquivalentUnits",
      "date": "2016-12-31;2016-01-01",
      "value": "57;59",
      "chapter": "Labor expense",
      "name": "Average number of employees in full time equivalent units",
      "bold": "yes",
      "depth": 0
    }
  ],
  "period_start": "2016-01-01",
  "period_end": "2016-12-31",
  "registered_at": "2017-06-26"
}

Error messages

In case of fatal problem, instead of result you will receive an error message

  • Token is wrong - you trying to access SOAP service with wrong or expired access token.
  • This request is not allowed for you - the request you trying to perform is not allowed for you. This may be a problem in our system, please contact support.
  • No such company - company you requested is not available. Check country and reg_code parameters are correct.
  • Only EST country supported in this request - currently, we have reports only for estonian companies. Change country to EST
  • This doc_type is not supported - doc_type of report you requested is not supported. Use A, X or D for doc_type
  • Cannot buy document. e-Business Register is currently not available due to technical reasons, try again later. - technical problem in Ariregister
  • Something went wrong - this is hypothetical situation, when something really went wrong

Example:

{
	"error": "error",
	"code": 0,
	"message": "This request is not allowed for you"
}

See also