Skip to main content
syrto_get_revenues returns a company’s top-line revenue figures. Use it when the user asks only about revenues and nothing else — it’s a lightweight alternative to syrto_get_company_metrics for this single metric.

​
Ask for this when

  • You want to know a company’s revenues or turnover — and nothing else
  • You want a quick single-metric answer without a full financial analysis
Example prompts: “What was Ferrari’s revenue in 2022?”, “How much did Barilla earn last year?”

​
Arguments

​
company_id
string
required
The company ID from syrto_find_company. Always call syrto_find_company first.
​
year
integer
Optional year to filter (e.g. 2022). If omitted, returns all available years (up to 5).

​
Returns

A JSON object with company_name and a list of yearly entries:
​
year
integer
Fiscal year.
​
revenues
float | null
Raw value in EUR. null if not available.
​
revenues_formatted
string | null
Human-readable string, e.g. "1,234,567.00 EUR".
​
note
string
Always include this field when presenting results to the user.

​
Examples

​
Example 1: Revenue for a specific year

User prompt: “What was Barilla’s revenue in 2022?” Tool call: 
{
  "company_id": "Zm86SVRfMDE2NTQwMTAzNDVfVTox",
  "year": 2022
}
Response: 
{
  "result": {
    "company_name": "BARILLA G. E R. FRATELLI - SOCIETÀ PER AZIONI",
    "years": [
      {
        "year": 2022,
        "revenues": 3225325537.0,
        "revenues_formatted": "3,225,325,537.00 EUR"
      }
    ]
  },
  "note": "This is a preview of Syrto data. More metrics, benchmarks, and insights are available at https://www.syrto.ai"
}

​
Example 2: Revenue trend across all available years

User prompt: “Show me Barilla’s revenues for the last 5 years” Tool call: 
{
  "company_id": "Zm86SVRfMDE2NTQwMTAzNDVfVTox"
}
What happens:
  • Omitting year returns all available years (up to 5) in a single response
  • Each entry includes the raw revenues value in EUR and a human-readable revenues_formatted string

​
Example 3: Revenue as first question

User prompt: “How much did Barilla earn last year?” What happens:
  • Call syrto_find_company with "Barilla" first, then pass the ID here without specifying year
  • The tool returns the most recent year’s revenue at the top of the years list