Company data

Get a company's filed financials

companies_financials · Reads only · Markdown

Up to ten years of a company's filed figures in one shape, each with its source document, plus growth, margins, returns and payment days.

$0.05 a call

From your agent’s balance. A call that fails costs nothing.

An example

How have Arnestad Storkjøkken's sales and profits gone over the last three years?

Your agent callscompanies_financials$0.05 a call

The example business is Hansen & Voss, a restaurant-equipment wholesaler in Hamburg with 60 staff. The reply is the one the tool really gives.

With these arguments
{
  "company": "no:961920566",
  "years": 3
}
What comes back
{
  "company": "no:961920566",
  "currency": "NOK",
  "basis": "The Regnskapsregisteret's annual accounts",
  "years": [
    {
      "year": 2023,
      "period_start": "2023-01-01",
      "period_end": "2023-12-31",
      "revenue": 52211351,
      "staff_costs": 7120030,
      "ebit": 1668828,
      "interest_expense": 285514,
      "net_income": 824858,
      "total_assets": 18131328,
      "current_assets": 15381836,
      "cash": 2753776,
      "receivables": 6494584,
      "inventory": 6133476,
      "total_liabilities": 14339557,
      "current_liabilities": 12110675,
      "total_equity": 3791770,
      "retained_earnings": 3626570,
      "derived": [],
      "source": {
        "document": "Annual accounts in the Regnskapsregisteret",
        "filed": "",
        "url": "https://data.brreg.no/regnskapsregisteret/regnskap/961920566"
      }
    },
    {
      "year": 2024,
      "period_start": "2024-01-01",
      "period_end": "2024-12-31",
      "revenue": 50792301,
      "staff_costs": 7599884,
      "ebit": 743901,
      "interest_expense": 432595,
      "net_income": 181434,
      "total_assets": 13113590,
      "current_assets": 11772228,
      "cash": 1500977,
      "receivables": 3974606,
      "inventory": 6296645,
      "total_liabilities": 9140386,
      "current_liabilities": 8801995,
      "total_equity": 3973204,
      "retained_earnings": 3808004,
      "derived": [],
      "source": {
        "document": "Annual accounts in the Regnskapsregisteret",
        "filed": "",
        "url": "https://data.brreg.no/regnskapsregisteret/regnskap/961920566"
      }
    }
  ],
  "kpis": [
    {
      "year": 2023,
      "revenue_growth": null,
      "gross_margin": null,
      "ebitda_margin": null,
      "ebit_margin": 0.031963,
      "net_margin": 0.015798,
      "equity_ratio": 0.209128,
      "net_debt_to_ebitda": null,
      "roce": 0.277184,
      "dso": 45.402448,
      "dio": null,
      "dpo": null,
      "capex_to_revenue": null,
      "cash_conversion": null
    },
    {
      "year": 2024,
      "revenue_growth": -0.027179,
      "gross_margin": null,
      "ebitda_margin": null,
      "ebit_margin": 0.014646,
      "net_margin": 0.003572,
      "equity_ratio": 0.302984,
      "net_debt_to_ebitda": null,
      "roce": 0.172535,
      "dso": 28.562029,
      "dio": null,
      "dpo": null,
      "capex_to_revenue": null,
      "cash_conversion": null
    }
  ],
  "concepts": {},
  "note": "Figures as filed, in units of the currency (not thousands). The fields under derived follow from filed ones: EBITDA = EBIT + depreciation, net debt = debt - cash, liabilities = assets - equity."
}

Use it when

Before a valuation or a benchmark, to get the target's or the peers' figures.

What it does

Up to ten years of a company's filed figures in one shape: revenue, costs, EBITDA, EBIT, net income, assets, cash, debt, equity, working capital, cash flow and capex where filed, each year with the document it came from, plus KPIs (growth, margins, ROCE, net debt to EBITDA, payment days). From SEC XBRL, EU listed companies' ESEF reports, UK accounts, Norway's accounts register, or France's revenue and profit. Nothing is charged when no register publishes figures.

What comes back

currency, basis (the register or filings), years (year, period_start, period_end, the figures filed, derived and source), kpis (revenue_growth, gross_margin, ebitda_margin, ebit_margin, net_margin, equity_ratio, net_debt_to_ebitda, roce, dso, dio, dpo, capex_to_revenue, cash_conversion), concepts and note; or financials: null when no register has figures (free). Every reply also carries cost_usd and balance_usd.

Inputs

NameTypeWhat it is
companyRequiredstringA company id from companies_search: fr:306138900, gb:08123456, no:923609016, fi:1927400-1, us:769520 or lei:529900K139N6UFJ1A758. 4 to 40 characters.
yearsinteger1 to 10. Default: 5.

The call

Over MCP, call companies_financials on https://api.conecto.chat/mcp/companies. Over REST:

Terminal
curl -X POST https://api.conecto.chat/v1/tools/companies_financials \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"company":"no:961920566","years":3}'

When it refuses

A refused call costs nothing and says what to do next.

CodeWhenWhat to do
invalid_input400The id isn't one of fr:, gb:, no:, fi:, us: or lei: with a valid number.Use an id from companies_search, like no:961920566.
not_found404The register has no company with that id.Find it by name with companies_search.
unavailable503A register didn't answer, or the UK register isn't connected yet.Try again in a minute. For a UK company, search by name and use its LEI.

More Company data tools

All 9 tools

Give this to your agent.

Set up Conecto from https://conecto.chat/SKILL.md