Skip to main content
Three tools work together to produce financial statements:

​
List templates

syrto_list_financial_statement_templates returns all available financial statement formats.

​
Arguments

​
string
"en" for English (default) or "it" for Italian.

​
Returns

A JSON list of templates, each with:
​
string
Template identifier - pass this to syrto_get_financial_statement_template or syrto_generate_financial_statement.
​
string
Human-readable template name.

​
Get template structure

syrto_get_financial_statement_template returns the blank line-item structure of a template, without any company values filled in.

​
Arguments

​
string
required
Template slug from syrto_list_financial_statement_templates.
​
string
"en" for English (default) or "it" for Italian.

​
Returns

​
string
Markdown template with (syrto_code) placeholders where values will be injected.

​
Generate a statement

syrto_generate_financial_statement fetches company metric values and injects them into the chosen template(s), producing a filled statement in markdown.

​
Arguments

​
string[]
required
The company, as a list holding exactly one ID - always a list, like every company tool. IDs come from syrto_find_company or syrto_lookup_companies_by_tax_id.This tool answers for one company. To ask about several in one call, use Compare companies for metrics, Company overview for profiles, or Company structure for ownership.
​
string[]
required
One or more template slugs (e.g. ["italian_income_statement"]). Use syrto_list_financial_statement_templates to discover available slugs. You can request multiple templates in a single call.
​
integer
Fiscal year to generate for (e.g. 2022). Defaults to the most recent available year.
​
string
"en" for English (default) or "it" for Italian.

​
Returns

A JSON list of generated statements, each with:
​
string
Legal name.
​
boolean
Which statement these figures are. false = the company’s own individual accounts, true = its group’s consolidated accounts. The two can differ by orders of magnitude, so state it when presenting the statement.
​
integer
Fiscal year of the generated statement.
​
string
ISO 8601 date of the financial statement the figures are derived from - the statement’s own date, normally the fiscal year end, not the date it was deposited. Omitted when no date is on record.
​
string
Human-readable template title.
​
string
Internal template identifier.
​
integer
Number of line items successfully filled with values.
​
integer
Total number of line items in the template.
​
string
Markdown with values injected inline as bold numbers.
When the company has nothing filed for the requested year, or nothing filed at all, result is an empty list and warning explains why - not an error. All three tools also return the fields every tool returns. On these tools display_title is always Syrto AI and subtitle is not set.

​
Example

Generate Barilla’s income statement for 2022:
Result:
  • Returns a filled income statement in markdown with metric values injected inline as bold numbers
  • metrics_matched shows how many line items were successfully populated out of total_slots