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

# Credit report

> A full credit report for an Italian company by fiscal code - identity, risk, ownership, officers, and recent financials.

Returns a full credit report for one company: identity and registry data, risk indicators, headcount, state aids, ownership and officers, and several recent years of headline financials. Ownership and officers carry names only, with no other personal identifiers.

<Info>
  Example endpoint. Whether it is part of your API depends on your organization's configuration - check [your schema](/api/openapi) for the endpoints provisioned for you.
</Info>

```
GET /companies/{fiscalCode}/credit-report
```

## Path parameters

<ParamField path="fiscalCode" type="string" required>
  The company's Italian fiscal code - either an 11-digit tax/VAT code or a 16-character codice fiscale. Case-insensitive.
</ParamField>

## Usage

Each successful call records a default measure of **10 credits**. The exact measure billed is always returned in `meta.usage` and may differ under your plan.

## Response

The `data` object contains:

<ResponseField name="id" type="string">Syrto's internal company identifier.</ResponseField>
<ResponseField name="isConsolidated" type="boolean">Whether the figures come from consolidated financial statements.</ResponseField>
<ResponseField name="latestFiledYear" type="number | null">The most recent fiscal year with filed figures.</ResponseField>

<ResponseField name="identity" type="CompanyIdentity">
  Descriptive company information (see [CompanyIdentity](/api/objects#companyidentity)), plus:

  * `foreignOwned` (`boolean | null`) - whether the company is foreign-owned.
  * `controllingEntity` (`string | null`) - the controlling entity, if any.
</ResponseField>

<ResponseField name="registry" type="object | null">
  Registry contacts, or `null`:

  * `pec` (`string | null`) - certified email address.
  * `cciaa` (`string | null`) - Chamber of Commerce registration.
  * `rea` (`string | null`) - REA number.
</ResponseField>

<ResponseField name="headcount" type="object | null">
  `null`, or `{ employees: number, asOf: string }` - employee count and the date it refers to.
</ResponseField>

<ResponseField name="risk" type="RiskIndicators">Risk flags. See [RiskIndicators](/api/objects#riskindicators).</ResponseField>

<ResponseField name="stateAids" type="object | null">
  State aid totals, or `null`. Fields `count`, `countLast36Months`, `amount`, `amountLast36Months` (each `number | null`).
</ResponseField>

<ResponseField name="ownership" type="object[]">
  Shareholders, each `{ name: string | null, share: number | null }` where `share` is an ownership fraction.
</ResponseField>

<ResponseField name="officers" type="object[]">
  Officers, each `{ name: string | null, role: string | null, roleCategory: string }`.
</ResponseField>

<ResponseField name="latest" type="AnnualSnapshot | null">The latest year of headline figures. See [AnnualSnapshot](/api/objects#annualsnapshot).</ResponseField>
<ResponseField name="financials" type="AnnualSnapshot[]">Recent years of headline figures, newest first. See [AnnualSnapshot](/api/objects#annualsnapshot).</ResponseField>

## Example

```bash theme={null}
curl -H "Authorization: Bearer $SYRTO_API_KEY" \
  https://api.syrto.ai/companies/01654010345/credit-report
```

```json theme={null}
{
  "data": {
    "id": "Zm86SVRfMDE2NTQwMTAzNDVfVTox",
    "isConsolidated": false,
    "latestFiledYear": 2023,
    "identity": {
      "legalName": "BARILLA G. E R. FRATELLI - SOCIETÀ PER AZIONI",
      "legalForm": "S.p.A.",
      "foundingYear": 1877,
      "incorporationDate": "1877-01-01",
      "isQuoted": false,
      "vatNumber": "01654010345",
      "fiscalCode": "01654010345",
      "naceCode": "10.73",
      "naceSection": "C",
      "address": {
        "line1": "Via Mantova 166",
        "line2": null,
        "locality": "Parma",
        "postalCode": "43122",
        "countryCode": "IT"
      },
      "foreignOwned": false,
      "controllingEntity": null
    },
    "registry": {
      "pec": "barilla@pec.example.it",
      "cciaa": "PR-123456",
      "rea": "PR-123456"
    },
    "headcount": { "employees": 8760, "asOf": "2023-12-31" },
    "risk": {
      "protestsOfBill": false,
      "insolvencyProceedings": false,
      "insolvencyApplications": false,
      "assetEncumbrances": false,
      "officersWithRiskIndicators": false
    },
    "stateAids": {
      "count": 12,
      "countLast36Months": 3,
      "amount": 1450000,
      "amountLast36Months": 320000
    },
    "ownership": [
      { "name": "Barilla Holding S.p.A.", "share": 0.85 }
    ],
    "officers": [
      { "name": "Guido Barilla", "role": "Chairman", "roleCategory": "board" }
    ],
    "latest": {
      "year": 2023,
      "isForecasted": false,
      "size": "L",
      "statementDate": "2023-12-31",
      "employees": 8760,
      "employeesYoY": 0.03
    },
    "financials": [
      { "year": 2023, "isForecasted": false, "size": "L", "statementDate": "2023-12-31", "employees": 8760, "employeesYoY": 0.03 },
      { "year": 2022, "isForecasted": false, "size": "L", "statementDate": "2022-12-31", "employees": 8505, "employeesYoY": 0.02 }
    ]
  },
  "meta": {
    "requestId": "req_018f9c2e7b7a7c3e9a1b2c3d4e5f6a7b",
    "endpoint": "company-credit-report",
    "usage": { "quantity": 10, "unit": "credits" }
  }
}
```