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 a specific year or across multiple years

​
Arguments

​
string
required
The company ID from syrto_find_company.
​
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 year to retrieve (e.g. 2022). If omitted, returns the most recent year only (controlled by last_n_years, which defaults to 1). Takes precedence over last_n_years.
​
integer
Number of most recent years to return. Default 1 (most recent year only). Max 5. Pass null to return all available years. Ignored when year is provided.
​
boolean
If true, each metric includes a market_value field with the sector benchmark for comparison. Default: false.
​
string
"en" for English (default) or "it" for Italian.
You cannot omit both metric_slugs and year - this would return all metrics across all years, exceeding response limits. Provide at least one.

​
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 - sector benchmark (only when include_market_data is true)
​
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.
​
string
Context note about data availability and where to find more on syrto.ai.
​
string
Link to the Syrto web app, where you can explore more data and insights.

​
Example

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