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.
​
string
Country/region applicability (e.g. "IT", "*").

​
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 ID from syrto_find_company.
​
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.
​
integer
Fiscal year of the generated statement.
​
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.
​
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.

​
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