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.

Three tools work together to produce financial statements:
ToolPurpose
syrto_list_financial_statement_templatesDiscover what statement formats are available
syrto_get_financial_statement_templatePreview the blank structure of a template
syrto_generate_financial_statementGenerate a statement filled with actual company values

List templates

syrto_list_financial_statement_templates returns all available financial statement formats.

Arguments

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

Returns

A JSON list of templates, each with:
template_slug
string
Template identifier — pass this to syrto_get_financial_statement_template or syrto_generate_financial_statement.
display_name
string
Human-readable template name.
countries
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

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

Returns

result
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

company_id
string
required
The company ID from syrto_find_company.
template_slugs
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.
year
integer
Fiscal year to generate for (e.g. 2022). Defaults to the most recent available year.
language
string
"en" for English (default) or "it" for Italian.

Returns

A JSON list of generated statements, each with:
company_name
string
Legal name.
year
integer
Fiscal year of the generated statement.
template_name
string
Human-readable template title.
template_slug
string
Internal template identifier.
metrics_matched
integer
Number of line items successfully filled with values.
total_slots
integer
Total number of line items in the template.
content
string
Markdown with values injected inline as bold numbers.
note
string
Context note about data availability and where to find more on syrto.ai.

Example

Generate Barilla’s income statement for 2022:
{
  "company_id": "Zm86SVRfMDE2NTQwMTAzNDVfVTox",
  "template_slugs": ["italian_income_statement"],
  "year": 2022,
  "language": "en"
}
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