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

# Response objects

> Shared object types that appear in the data of multiple Syrto API endpoints.

Several object types are reused across endpoints. They're documented once here; each endpoint page links back to the ones it uses. Fields typed `… | null` are always present but may be `null` when the value is unknown.

## CompanyIdentity

Descriptive, non-financial information about a company.

<ResponseField name="legalName" type="string | null">The official registered company name.</ResponseField>
<ResponseField name="legalForm" type="string | null">The legal form (e.g. S.p.A., S.r.l.).</ResponseField>
<ResponseField name="foundingYear" type="number | null">Year the company was founded.</ResponseField>
<ResponseField name="incorporationDate" type="string | null">Incorporation date.</ResponseField>
<ResponseField name="isQuoted" type="boolean | null">Whether the company is listed on a stock exchange.</ResponseField>
<ResponseField name="vatNumber" type="string | null">Italian VAT number (partita IVA).</ResponseField>
<ResponseField name="fiscalCode" type="string | null">Italian fiscal code (codice fiscale).</ResponseField>
<ResponseField name="naceCode" type="string | null">NACE economic activity code.</ResponseField>
<ResponseField name="naceSection" type="string | null">NACE section (the top-level letter).</ResponseField>
<ResponseField name="address" type="Address | null">Registered address. See [Address](#address).</ResponseField>

Some endpoints extend `CompanyIdentity` with extra fields (for example `foreignOwned`, `controllingEntity`, `activityStartDate`, `dissolutionYear`); those additions are noted on the relevant endpoint page.

## Address

<ResponseField name="line1" type="string | null">First address line.</ResponseField>
<ResponseField name="line2" type="string | null">Second address line.</ResponseField>
<ResponseField name="locality" type="string | null">City or town.</ResponseField>
<ResponseField name="postalCode" type="string | null">Postal code (CAP).</ResponseField>
<ResponseField name="countryCode" type="string">ISO 3166-1 alpha-2 country code.</ResponseField>

## AnnualSnapshot

A single fiscal year of headline figures.

<ResponseField name="year" type="number">The fiscal year.</ResponseField>
<ResponseField name="isForecasted" type="boolean">Whether the figures are forecast rather than reported.</ResponseField>
<ResponseField name="size" type="string | null">Company size band (e.g. `XS`, `S`, `M`, `L`).</ResponseField>
<ResponseField name="statementDate" type="string | null">Date of the financial statement.</ResponseField>
<ResponseField name="employees" type="number | null">Employee count for the year.</ResponseField>
<ResponseField name="employeesYoY" type="number | null">Year-over-year change in employee count.</ResponseField>

## RiskIndicators

Boolean flags summarising risk. Each is `true`, `false`, or `null` when unknown.

<ResponseField name="protestsOfBill" type="boolean | null">Protested bills on record.</ResponseField>
<ResponseField name="insolvencyProceedings" type="boolean | null">Active insolvency proceedings.</ResponseField>
<ResponseField name="insolvencyApplications" type="boolean | null">Insolvency applications filed.</ResponseField>
<ResponseField name="assetEncumbrances" type="boolean | null">Encumbrances on company assets.</ResponseField>
<ResponseField name="officersWithRiskIndicators" type="boolean | null">Officers carrying their own risk indicators.</ResponseField>

## FinancialMetric

A single financial statement line item or metric.

<ResponseField name="slug" type="string">Stable metric identifier.</ResponseField>
<ResponseField name="name" type="string">Human-readable metric name.</ResponseField>
<ResponseField name="categories" type="string[]">Categories the metric belongs to.</ResponseField>
<ResponseField name="unit" type="string | null">Unit of measure.</ResponseField>
<ResponseField name="value" type="number">The metric value for the year.</ResponseField>
<ResponseField name="previousValue" type="number | null">The value for the previous year.</ResponseField>
<ResponseField name="yoyChange" type="number | null">Year-over-year change.</ResponseField>
<ResponseField name="marketValue" type="number | null">A reference market value for the metric, where available.</ResponseField>
<ResponseField name="score" type="number | null">Syrto score for the metric, where available.</ResponseField>

## CompanyBranch

<ResponseField name="legalName" type="string">The branch's registered name.</ResponseField>
<ResponseField name="address" type="Address | null">The branch address. See [Address](#address).</ResponseField>
