Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.syrto.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

​
company_id
string
required
The company ID from syrto_find_company.
​
metric_slugs
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.
​
year
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.
​
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.
​
include_market_data
boolean
If true, each metric includes a market_value field with the sector benchmark for comparison. Default: false.
​
language
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, available_years, and per-year data. Each year contains:
​
available_years
integer[]
All fiscal years with data for this company.
​
year
integer
Fiscal year.
​
size
string
EU SME classification for that year.
​
employee_count
float | null
Headcount for that year.
​
metrics
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
  • market_value — sector benchmark (only when include_market_data is true)
​
radar.efficiency
float | null
Efficiency score (0–100): how well the company converts resources into results.
​
radar.size
float | null
Size score (0–100): how large and stable the company is relative to its sector.
​
radar.trajectory_distance / trajectory_angle
float
Year-on-year movement in the radar space.
​
note
string
Context note about data availability and where to find more on syrto.ai.

​
Example

Get specific balance sheet metrics for Barilla: 
{
  "company_id": "Zm86SVRfMDE2NTQwMTAzNDVfVTox",
  "metric_slugs": ["total_assets", "net_financial_position"]
}
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