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.
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
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.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.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.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, the most recent filed year is returned.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.
List of metric objects, each with:
name- human-readable metric nameslug- internal identifier (usenamefor display)value- 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 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:- Returns only the requested metrics for the most recent filed year by default
- Use
recent_yearsfor trends, oryearsfor specific periods - Use
syrto_list_available_metricsto discover available slugs