syrto_get_company_analysis is the primary tool for financial analysis. It returns all metrics that drive the Syrto radar scores, pre-grouped into four categories, plus radar positioning and explanations - in a single call.
Use this tool to
- Get a comprehensive financial assessment across profitability, liquidity, solvency, and structure
- See radar scores (efficiency and size) alongside the metrics that drive them
- Compare performance year-on-year
Arguments
The company, as a list holding exactly one ID - always a list, like every company tool. IDs come from
syrto_find_company or syrto_lookup_companies_by_tax_id.This tool answers for one company. To ask about several in one call, use Compare companies for metrics, Company overview for profiles, or Company structure for ownership.Fiscal years to retrieve, as a list even for a single year -
[2023] or [2023, 2022]. Up to 10 years, each named once. Results always come back newest-first, whatever order you list them in. Naming a year returns that year alone. Any year the company filed is reachable, however old; a year it never filed is simply absent from the response, and available_years lists every year it did file.Mutually exclusive with recent_years - pass one or neither, never both.How many of the most recent filed years to return,
1-10 - for example 3 for a three-year trend. Use this rather than years for a relative request, since it needs no knowledge of which years the company filed.Mutually exclusive with years.If
true, each metric includes a market_value field with the reference-market benchmark for comparison. Default: false.When both
years and recent_years are omitted, this tool returns the two most recent filed years, so the latest figures arrive with a year of trend context beside them.Returns
A JSON object withcompany_name, consolidated, available_years, and per-year data. Each year contains:
Which statement these figures are.
false = the company’s own individual accounts, true = its group’s consolidated accounts. The two can differ by orders of magnitude, so state which basis a figure is on whenever it is a number someone might check against a published report.ISO 8601 date of the financial statement the figures are derived from. This is the statement’s own date - normally the fiscal year end - not the date it was deposited or published. Omitted when no date is on record.
Efficiency score (0–100): how well the company converts resources into results. Higher is better.
Size score (0–100): how large and stable the company is relative to its sector. Higher is better.
Structured explanation of what drives the efficiency and size positioning, and its movement since the prior year. Contains two top-level keys,
efficiency and size, each an object with movement and position, and each of those containing:value- numeric scorecontributions- list of items, each withcontribution(a signed weight, not a value or a percentage) and the driver it names
metric_slug plus metric_name) or a category (category_slug plus category_name) - both kinds occur on both axes. The human-readable name travels with the slug, so what moved a score can be described from this response alone without a second lookup.The four Syrto financial categories, each with:
name- human-readable category nameslug- internal category identifier (e.g."profitability","liquidity")metrics- list of metric objects, each with:name- human-readable metric nameslug- internal metric identifiervalue- numeric value (ornullif unavailable)better_when- object{"when_type": "HIGHER"},{"when_type": "LOWER"},{"when_type": "NEAR_TARGET"}, ornullscore- integer 1-5 rating the value against the company’s reference market. Already normalised for direction, so 5 is best for every metric, including ones where a lower raw value is better - never re-rank it bybetter_when. Omitted when the metric has no scoring strategy.market_value- the reference-market benchmark (only wheninclude_market_dataistrue)
score and market_value is companies in the same NACE class (4-digit) and size band (XS/S/M/L) in the same year, within the same NUTS 1 macro-region - country-wide for size L. It is not a national sector average. No field in the response names the market, so the comparison cannot be attributed to a particular region or peer set.result, the response carries the fields every tool returns. Here display_title is the company’s legal name and subtitle its statement basis and the latest fiscal year returned, for example Individual statement · FY2024. warning says when a year you named was not filed, or when the years returned have a gap.
The four categories
null metric values mean data is not available. The slug fields are internal identifiers - use the name fields for display.Example
Full financial analysis of Barilla:- Returns the two most recent filed years by default (pass
recent_years: 1for just the latest, oryearsfor specific ones) - Includes all four categories with their metrics, radar scores (efficiency and size), and an explanation of what drives the positioning