Skip to main content
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.
This is the best starting point for any financial assessment. Only reach for syrto_get_company_metrics when you need specific metrics not covered by the four categories below.

​
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. For thematic breakdowns, use Spider graphs. For qualitative profile data, use Company overview.

​
Arguments

​
string
required
The company ID from syrto_find_company.
​
integer
Fiscal year to retrieve (e.g. 2022). If omitted, returns the most recent year plus the prior year (controlled by include_prior_year).
​
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.
​
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.

​
Returns

A JSON object with company_name, available_years, and per-year data. Each year contains:
​
integer[]
All fiscal years with data for this company.
​
integer
Fiscal year.
​
string
EU SME classification for that year (e.g. “Large”, “Medium”).
​
float | null
Headcount for that year. null if not available.
​
float | null
Efficiency score (0–100): how well the company converts resources into results. Higher is better.
​
float | null
Size score (0–100): how large and stable the company is relative to its sector. Higher is better.
​
float
Year-on-year movement in the radar space - magnitude and direction of change.
​
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
​
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)
​
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.

​
The four categories

null metric values mean data is not available. The slug fields are internal identifiers - use the name fields for display.

​
Example

Full financial analysis of Barilla:
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