Skip to main content
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.
This is the best starting point for any financial assessment. Only reach for syrto_get_company_metrics when you need specific metrics not covered by the four categories below, such as ROI, ROIC or operating cash flow.

​
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
Related tools: For specific metrics outside the four categories, use Company metrics. For thematic breakdowns, use Spider graphs. For qualitative profile data, use Company overview.

​
Arguments

​
string[]
required
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.
​
integer[]
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.
​
integer
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.
​
boolean
If true, each metric includes a market_value field with the reference-market benchmark for comparison. Default: false.
​
string
"en" for English (default) or "it" for Italian.
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 with company_name, consolidated, available_years, and per-year data. Each year contains:
​
boolean
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.
​
integer[]
All fiscal years with data for this company.
​
integer
Fiscal year.
​
string
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.
​
string
EU SME classification for that year (e.g. “Large”, “Medium”).
​
float | null
Headcount for that year. null if not available.
​
float | null
Efficiency score (0–100): how well the company converts resources into results. Higher is better.
​
float | null
Size score (0–100): how large and stable the company is relative to its sector. Higher is better.
​
float
Year-on-year movement in the radar space - magnitude and direction of change.
​
object | null
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 score
  • contributions - list of items, each with contribution (a signed weight, not a value or a percentage) and the driver it names
A contribution names either a metric (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.
​
object[]
The four Syrto financial categories, each with:
  • name - human-readable category name
  • slug - internal category identifier (e.g. "profitability", "liquidity")
  • metrics - list of metric objects, each with:
    • name - human-readable metric name
    • slug - internal metric identifier
    • value - numeric value (or null if unavailable)
    • better_when - object {"when_type": "HIGHER"}, {"when_type": "LOWER"}, {"when_type": "NEAR_TARGET"}, or null
    • score - 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 by better_when. Omitted when the metric has no scoring strategy.
    • market_value - the reference-market benchmark (only when include_market_data is true)
The reference market behind both 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.
Beside 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:
Result:
  • Returns the two most recent filed years by default (pass recent_years: 1 for just the latest, or years for specific ones)
  • Includes all four categories with their metrics, radar scores (efficiency and size), and an explanation of what drives the positioning