--- name: "companies_financials" area: "companies" title: "Get a company's filed financials" price: "$0.05" method: "POST" url: "https://api.conecto.chat/v1/tools/companies_financials" mcp_server: "https://api.conecto.chat/mcp/companies" auth: "Authorization: Bearer " docs_url: "https://conecto.chat/tools/companies/companies_financials" --- # Get a company's filed financials (`companies_financials`) 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. 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. Price: $0.05 a call. A call that fails costs nothing. ## Use it when Before a valuation or a benchmark, to get the target's or the peers' figures. - For a value from the figures, use [valuation_dcf](https://conecto.chat/tools/valuation/valuation_dcf.md). ## Say this to your agent > How have Arnestad Storkjøkken's sales and profits gone over the last three years? ## Inputs | Name | Type | Required | Description | Allowed values | Default | |---|---|---|---|---|---| | `company` | string | yes | A company id from companies_search: fr:306138900, gb:08123456, no:923609016, fi:1927400-1, us:769520 or lei:529900K139N6UFJ1A758. 4 to 40 characters. | | | | `years` | integer | no | 1 to 10. | | `5` | ## Example Written for Hansen & Voss, a restaurant-equipment wholesaler in Hamburg with 60 staff. MCP: call `companies_financials` on the MCP server `https://api.conecto.chat/mcp/companies` with these arguments: ```json { "company": "no:961920566", "years": 3 } ``` REST: ```bash curl https://api.conecto.chat/v1/tools/companies_financials \ -H "Authorization: Bearer $CONECTO_KEY" \ -H "Content-Type: application/json" \ -d '{"company": "no:961920566", "years": 3}' ``` ## Response ```json { "call_id": "5f0c8a2e-3b7d-4c1e-9a64-2d8e1f7b0c93", "tool": "companies_financials", "status": "succeeded", "replayed": false, "cost_usd": "$0.05", "balance_usd": "$19.75", "result": { "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.0, "staff_costs": 7120030.0, "ebit": 1668828.0, "interest_expense": 285514.0, "net_income": 824858.0, "total_assets": 18131328.0, "current_assets": 15381836.0, "cash": 2753776.0, "receivables": 6494584.0, "inventory": 6133476.0, "total_liabilities": 14339557.0, "current_liabilities": 12110675.0, "total_equity": 3791770.0, "retained_earnings": 3626570.0, "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.0, "staff_costs": 7599884.0, "ebit": 743901.0, "interest_expense": 432595.0, "net_income": 181434.0, "total_assets": 13113590.0, "current_assets": 11772228.0, "cash": 1500977.0, "receivables": 3974606.0, "inventory": 6296645.0, "total_liabilities": 9140386.0, "current_liabilities": 8801995.0, "total_equity": 3973204.0, "retained_earnings": 3808004.0, "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." } } ``` `result`: 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). ## Errors | Code | Status | When | Fix | |---|---|---|---| | `invalid_input` | 400 | The 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_found` | 404 | The register has no company with that id. | Find it by name with companies_search. | | `unavailable` | 503 | A 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. | The refusals every tool can give (401 key, 402 balance, 429 limits) are on the errors page: https://conecto.chat/docs/errors.md ## Related - [companies_search](https://conecto.chat/tools/companies/companies_search.md): Companies by name or id across the public registers, each with its id, country, status, city and industry, best match first. Free up to 1,000,000 reads a month. - [companies_get](https://conecto.chat/tools/companies/companies_get.md): A company's record in its register: legal form, status, address, industry, employees, LEI and its officers by name and role. $0.05 a call. - [companies_save_accounts](https://conecto.chat/tools/companies/companies_save_accounts.md): A UK company's annual accounts as filed with Companies House, saved to the file store as a PDF: the latest, or a year's. $0.001 a call. - [companies_read_accounts](https://conecto.chat/tools/companies/companies_read_accounts.md): The balance sheet and income statement read out of an annual report PDF, a scan by OCR, line by line with its page, German HGB or English. $0.05 a call. - [companies_owners](https://conecto.chat/tools/companies/companies_owners.md): A company's parents and subsidiaries from GLEIF, the SEC and Wikidata and, in the UK, the people and companies with significant control. $0.05 a call. - [companies_legal_notice](https://conecto.chat/tools/companies/companies_legal_notice.md): A company's legal notice (Impressum) read from its own website: legal name, register court and number, managers and VAT number. $0.01 a call. - [companies_estimate](https://conecto.chat/tools/companies/companies_estimate.md): A revenue estimate from headcount and Eurostat's turnover per person employed for the size class and industry, always labeled as an estimate. Free up to 1,000,000 reads a month. - [companies_match](https://conecto.chat/tools/companies/companies_match.md): Matches a company list (CSV, Excel or rows) to the registers in the background, with a results file of each match. $0.01 per row matched.