> ## 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.

# Financial statements

> List, preview, and generate filled financial statements for a company.

Three tools work together to produce financial statements:

| Tool                                       | Purpose                                                |
| ------------------------------------------ | ------------------------------------------------------ |
| `syrto_list_financial_statement_templates` | Discover what statement formats are available          |
| `syrto_get_financial_statement_template`   | Preview the blank structure of a template              |
| `syrto_generate_financial_statement`       | Generate a statement filled with actual company values |

***

## List templates

`syrto_list_financial_statement_templates` returns all available financial statement formats.

### Arguments

<ParamField query="language" type="string">
  `"en"` for English (default) or `"it"` for Italian.
</ParamField>

### Returns

A JSON list of templates, each with:

<ResponseField name="template_slug" type="string">
  Template identifier — pass this to `syrto_get_financial_statement_template` or `syrto_generate_financial_statement`.
</ResponseField>

<ResponseField name="display_name" type="string">
  Human-readable template name.
</ResponseField>

<ResponseField name="countries" type="string">
  Country/region applicability (e.g. `"IT"`, `"*"`).
</ResponseField>

***

## Get template structure

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

### Arguments

<ParamField query="slug" type="string" required>
  Template slug from `syrto_list_financial_statement_templates`.
</ParamField>

<ParamField query="language" type="string">
  `"en"` for English (default) or `"it"` for Italian.
</ParamField>

### Returns

<ResponseField name="result" type="string">
  Markdown template with `(syrto_code)` placeholders where values will be injected.
</ResponseField>

***

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

<ParamField query="company_id" type="string" required>
  The company ID from [`syrto_find_company`](/mcp/tools/find-company).
</ParamField>

<ParamField query="template_slugs" type="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.
</ParamField>

<ParamField query="year" type="integer">
  Fiscal year to generate for (e.g. `2022`). Defaults to the most recent available year.
</ParamField>

<ParamField query="language" type="string">
  `"en"` for English (default) or `"it"` for Italian.
</ParamField>

### Returns

A JSON list of generated statements, each with:

<ResponseField name="company_name" type="string">
  Legal name.
</ResponseField>

<ResponseField name="year" type="integer">
  Fiscal year of the generated statement.
</ResponseField>

<ResponseField name="template_name" type="string">
  Human-readable template title.
</ResponseField>

<ResponseField name="template_slug" type="string">
  Internal template identifier.
</ResponseField>

<ResponseField name="metrics_matched" type="integer">
  Number of line items successfully filled with values.
</ResponseField>

<ResponseField name="total_slots" type="integer">
  Total number of line items in the template.
</ResponseField>

<ResponseField name="content" type="string">
  Markdown with values injected inline as **bold numbers**.
</ResponseField>

<ResponseField name="note" type="string">
  Context note about data availability and where to find more on syrto.ai.
</ResponseField>

### Example

**Generate Barilla's income statement for 2022:**

```json theme={null}
{
  "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`