Want more financial KPIs than just a revenue?

All the financial figures

Vainu offers various financial figures besides revenue and profit to better understand how the company performs and functions. At the API, you can find common financial numbers, like revenue, on the response root. These values are always the most recent ones.

For other values, the API has a financial_statements list, which includes all the values Vainu could get from financial statements. This list contains data sorted by year, so it is possible to view historical data, analyse changes and even build complex graphs indicating how specific figures have evolved.

Get financial statements

The Get Companies endpoint can be used to get all the financial statements from the company or range of companies you are looking for. The following request will return all the financial_statements with company_name from a specified business id.

GET https://api.vainu.io/api/v2/companies/
    ?country=FI
  &business_id=08077512
  &fields=financial_statements,company_name

The financial statements you will receive will look like this.

{
     "modified": "2021-11-04T11:03:26.558000",
     "created": "2021-11-08T06:39:46.714000",
     "journal_number": "2019_13414T",
     "account_period_end": "2018-12-31",
     "account_period_start": "2018-01-01",
     "year": 2018,
     "currency_code": "EUR",
     "turn_over_local": "7339199",
     "other_operating_income": 71293.25,
     "other_operating_income_local": 71293.25,
     "net_operating_income_local": 7410492.44,
     "cost_of_goods_and_services_sold": -867059.68,
     "cost_of_goods_and_services_sold_local": -867059.68,
     "other_costs_local": -650287.73,
     "employee_salary_local": -2104076.5,
     "employee_salary": -2104076.5,
     "depreciation_costs_local": -184933.41,
     "depreciation_costs": -184933.41,
     "operating_income_local": 996550.3,
     "operating_income": 996550.3,
     "interest_income_local": -57852.47,
     "interest_income": -57852.47,
     "interest_expense_local": -36004.26,
     "interest_expense": -36004.26,
     "income_tax": -208062.67,
     "income_tax_local": -208062.67,
     "dividends_given": 296392.0,
     "bs_total_long_term_assets_local": 22326.48,
     "bs_total_long_term_assets": 22326.48,
     "bs_inventory_local": 1439815.64,
     "bs_inventory": 1439815.64,
     "bs_accounts_receivable_current_local": 413839.74,
     "bs_accounts_receivable_current": 413839.74,
     "bs_prepaid_expenses_local": 212155.51,
     "bs_cash_and_cash_equivalents_local": 627962.24,
     "bs_cash_and_cash_equivalents": 627962.24,
     "bs_total_current_assets_local": 7046116.22,
     "bs_total_current_assets": 7046116.22,
     "bs_total_assets": 7068442.7,
     "bs_issued_share_capital_local": 23970.0,
     "bs_total_equity": 3704950.34,
     "bs_total_long_term_debts_local": 970000.0,
     "bs_total_long_term_debts": 970000.0,
     "bs_accounts_payable_current_local": 546855.13,
     "bs_accounts_payable_current": 546855.13,
     "bs_total_current_liabilities_local": 2393492.36,
     "bs_total_current_liabilities": 2393492.36,
     "total_liabilities_local": 3363492.36,
     "total_liabilities": 3363492.36,
     "bs_total_equity_and_liab_local": 7068442.7,
     "bs_total_equity_and_liab": 7068442.7,
     "insolvency_date_type": [],
     "development_of_turnover": "-4.53",
     "development_of_net_income": -4.83,
     "sum_of_turnover_net_income_developments": -9.36,
     "sum_of_turnover_development_and_profit_margin": 8.92,
     "kr_gross_profit_local_margin_percent": 88.3,
     "equity_to_assets_ratio": "52.42",
     "profit": "13.45",
     "kr_net_margin_percent": 10.93,
     "kr_current_ratio": 294.39,
     "kr_return_on_assets": 11.46,
     "kr_debt_to_equity": 90.78,
     "kr_interest_coverage": -2767.87,
     "kr_inventory_turnover": -60.22,
     "kr_asset_turnover": 104.84,
     "turnover_estimate": null,
     "other_costs": -650287.73,
     "bs_issued_share_capital": 23970.0,
     "bs_prepaid_expenses": 212155.51,
     "net_operating_income": 7410492.44,
     "turn_over_eur": "7339199",
     "net_income_euro": "810335",
     "net_income_local": "810335",
     "result_before_taxes_euro": "1018398",
     "result_before_taxes_local": "1018398",
     "quick_ratio_percent": 234.23,
     "return_on_equity": 21.87,
     "return_on_investment": 14.098583553630561,
     "total_equity": 3704950.34,
     "total_assets": 7068442.7,
     "turn_over_is_estimate": false,
     "staff_number_is_estimate": false
 }

Each year will have its own numbers within the list. Loop through the list and use years to get the year you are looking for. Financial statements are usually released once a year, and Vainu might have some numbers for the company even though the financial statement has not been released yet.

For the current values, you can look for the newest statement where the field isn't empty.