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

> Get a full categorised financial analysis of a company — profitability, liquidity, solvency, and structure — with radar scores in a single call.

`syrto_get_company_analysis` is the primary tool for financial analysis. It returns all metrics that drive the Syrto radar scores, pre-grouped into four categories, plus radar positioning and explanations — in a single call.

<Tip>
  This is the best starting point for any financial assessment. Only reach for [`syrto_get_company_metrics`](/mcp/tools/company-metrics) when you need specific metrics not covered by the four categories below.
</Tip>

## Use this tool to

* Get a comprehensive financial assessment across profitability, liquidity, solvency, and structure
* See radar scores (efficiency and size) alongside the metrics that drive them
* Compare performance year-on-year

**Related tools:** For specific metrics outside the four categories, use [Company metrics](/mcp/tools/company-metrics). For thematic breakdowns, use [Spider graphs](/mcp/tools/spider-graphs). For qualitative profile data, use [Company overview](/mcp/tools/company-overview).

## Arguments

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

<ParamField query="year" type="integer">
  Fiscal year to retrieve (e.g. `2022`). If omitted, returns the most recent year plus the prior year (controlled by `include_prior_year`).
</ParamField>

<ParamField query="include_prior_year" type="boolean">
  When `true` (default), returns the most recent year plus the prior year for trend context. When `false`, returns only the most recent year. 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>

## 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 (e.g. "Large", "Medium").
</ResponseField>

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

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

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

<ResponseField name="radar.trajectory_distance / trajectory_angle" type="float">
  Year-on-year movement in the radar space — magnitude and direction of change.
</ResponseField>

<ResponseField name="radar.explanation" type="object | null">
  Structured explanation of what drives the efficiency and size positioning. Contains two top-level keys:

  * `efficiency` — object with `movement` and `position`, each containing:
    * `value` — numeric score
    * `contributions` — list of items, each with `contribution` (float) and `category_slug` identifying the driver
  * `size` — same structure as `efficiency`, but contributions use `metric_slug` instead of `category_slug`
</ResponseField>

<ResponseField name="categories" type="object[]">
  The four Syrto financial categories, each with:

  * `name` — human-readable category name
  * `slug` — internal category identifier (e.g. `"profitability"`, `"liquidity"`)
  * `metrics` — list of metric objects, each with:
    * `name` — human-readable metric name
    * `slug` — internal metric identifier
    * `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="note" type="string">
  Context note about data availability and where to find more on syrto.ai.
</ResponseField>

### The four categories

| Category          | What it covers                                                 |
| ----------------- | -------------------------------------------------------------- |
| **Profitability** | Margins (EBITDA, EBIT), returns (ROE, ROA), revenue growth     |
| **Liquidity**     | Working capital, cash conversion cycle, short-term buffers     |
| **Solvency**      | Debt load, coverage ratios, leverage, financial sustainability |
| **Structure**     | Asset composition, capital structure, capex intensity          |

<Note>
  `null` metric values mean data is not available. The `slug` fields are internal identifiers — use the `name` fields for display.
</Note>

## Example

**Full financial analysis of Barilla:**

```json theme={null}
{
  "company_id": "Zm86SVRfMDE2NTQwMTAzNDVfVTox"
}
```

**Result:**

* Returns the most recent year plus the prior year by default (set `include_prior_year` to `false` for just the latest year)
* Includes all four categories with their metrics, radar scores (efficiency and size), and an explanation of what drives the positioning