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

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

​
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 (e.g. “Large”, “Medium”).
​
employee_count
float | null
Headcount for that year. null if not available.
​
radar.efficiency
float | null
Efficiency score (0–100): how well the company converts resources into results. Higher is better.
​
radar.size
float | null
Size score (0–100): how large and stable the company is relative to its sector. Higher is better.
​
radar.trajectory_distance / trajectory_angle
float
Year-on-year movement in the radar space — magnitude and direction of change.
​
radar.explanation
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
​
categories
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)
​
note
string
Context note about data availability and where to find more on syrto.ai.

​
The four categories

CategoryWhat it covers
ProfitabilityMargins (EBITDA, EBIT), returns (ROE, ROA), revenue growth
LiquidityWorking capital, cash conversion cycle, short-term buffers
SolvencyDebt load, coverage ratios, leverage, financial sustainability
StructureAsset composition, capital structure, capex intensity
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: 
{
  "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