> ## 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.

# Company metrics

> Retrieve specific financial metric values for a company by slug — use when you need metrics outside what syrto_get_company_analysis covers.

`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`](/mcp/tools/company-analysis) — for example, individual balance sheet line items, custom metric sets, or precise comparisons across companies.

<Tip>
  For general financial analysis, use [`syrto_get_company_analysis`](/mcp/tools/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`](/mcp/tools/list-available-metrics) or [`syrto_search_metric_definitions`](/mcp/tools/metric-definitions).
</Tip>

## 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

<ParamField query="company_id" type="string" required>
  The company ID from [`syrto_find_company`](/mcp/tools/find-company).
</ParamField>

<ParamField query="metric_slugs" type="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`](/mcp/tools/list-available-metrics) to discover slugs.
</ParamField>

<ParamField query="year" type="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`.
</ParamField>

<ParamField query="last_n_years" type="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.
</ParamField>

<ParamField query="include_market_data" type="boolean">
  If `true`, each metric includes a `market_value` field with the sector benchmark for comparison. Default: `false`.
</ParamField>

<ParamField query="language" type="string">
  `"en"` for English (default) or `"it"` for Italian.
</ParamField>

<Warning>
  You cannot omit both `metric_slugs` and `year` — this would return all metrics across all years, exceeding response limits. Provide at least one.
</Warning>

## Returns

A JSON object with `company_name`, `available_years`, and per-year data. Each year contains:

<ResponseField name="available_years" type="integer[]">
  All fiscal years with data for this company.
</ResponseField>

<ResponseField name="year" type="integer">
  Fiscal year.
</ResponseField>

<ResponseField name="size" type="string">
  EU SME classification for that year.
</ResponseField>

<ResponseField name="employee_count" type="float | null">
  Headcount for that year.
</ResponseField>

<ResponseField name="metrics" type="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`)
</ResponseField>

<ResponseField name="radar.efficiency" type="float | null">
  Efficiency score (0–100): how well the company converts resources into results.
</ResponseField>

<ResponseField name="radar.size" type="float | null">
  Size score (0–100): how large and stable the company is relative to its sector.
</ResponseField>

<ResponseField name="radar.trajectory_distance / trajectory_angle" type="float">
  Year-on-year movement in the radar space.
</ResponseField>

<ResponseField name="note" type="string">
  Context note about data availability and where to find more on syrto.ai.
</ResponseField>

## Example

**Get specific balance sheet metrics for Barilla:**

```json theme={null}
{
  "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`](/mcp/tools/list-available-metrics) to discover available slugs