Skip to main content
syrto_get_company_metrics retrieves individual metric values by slug for a company. Use it when you need specific metrics not already covered by syrto_get_company_analysis - for example, individual balance sheet line items, custom metric sets, or precise comparisons across companies.
For general financial analysis, use syrto_get_company_analysis instead - it returns all four Syrto categories plus radar scores in a single call, with no slug discovery needed.To find metric slugs, use syrto_list_available_metrics or syrto_search_metric_definitions.

​
Use this tool to

  • Retrieve specific metrics not covered by the four Syrto categories (e.g. raw balance sheet items, niche ratios)
  • Compare companies on a custom metric set
  • Get metric values for specific fiscal years, or a run of recent ones

​
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.
​
string[]
List of metric slugs to retrieve (e.g. ["total_assets", "net_financial_position"]). If omitted, returns all available metrics. Use syrto_list_available_metrics to discover slugs.
​
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. 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, the most recent filed year is returned.
metric_slugs is required unless you also name the years, with either years or recent_years - omitting all three would return every metric across every filed year, exceeding response limits.

​
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.
​
float | null
Headcount for that year.
​
object[]
List of metric objects, each with:
  • name - human-readable metric name
  • slug - internal identifier (use name for display)
  • 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.
​
float | null
Efficiency score (0–100): how well the company converts resources into results.
​
float | null
Size score (0–100): how large and stable the company is relative to its sector.
​
float
Year-on-year movement in the radar space.
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 names every requested slug that returned no data, and says why: a slug that is not a known metric (search for the right one) is reported apart from a known metric that has no value in any filed year, where searching will not help. It also says when a year you named was not filed, or when the years returned have a gap.

​
Example

Get specific balance sheet metrics for Barilla:
Result:
  • Returns only the requested metrics for the most recent filed year by default
  • Use recent_years for trends, or years for specific periods
  • Use syrto_list_available_metrics to discover available slugs