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

> Un credit report completo di un'azienda italiana tramite codice fiscale - identità, rischio, assetto proprietario, cariche e dati finanziari recenti.

Restituisce un credit report completo di un'azienda: dati anagrafici e di registro, indicatori di rischio, organico, aiuti di stato, assetto proprietario e cariche, e diversi esercizi recenti di cifre di sintesi. Assetto proprietario e cariche riportano solo i nomi, senza altri identificatori personali.

<Info>
  Endpoint di esempio. La sua presenza nella tua API dipende dalla configurazione della tua organizzazione - consulta la [tua specifica](/it/api/openapi) per gli endpoint predisposti per te.
</Info>

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

## Parametri di path

<ParamField path="fiscalCode" type="string" required>
  Il codice fiscale italiano dell'azienda - un codice fiscale/partita IVA di 11 cifre oppure un codice fiscale di 16 caratteri. Non distingue tra maiuscole e minuscole.
</ParamField>

## Utilizzo

Ogni chiamata riuscita registra una misura predefinita di **10 credits**. La misura effettivamente addebitata è sempre restituita in `meta.usage` e può variare in base al tuo piano.

## Risposta

L'oggetto `data` contiene:

<ResponseField name="id" type="string">L'identificatore interno dell'azienda in Syrto.</ResponseField>
<ResponseField name="isConsolidated" type="boolean">Se le cifre provengono da bilanci consolidati.</ResponseField>
<ResponseField name="latestFiledYear" type="number | null">L'esercizio più recente con cifre depositate.</ResponseField>

<ResponseField name="identity" type="CompanyIdentity">
  Informazioni descrittive dell'azienda (vedi [CompanyIdentity](/it/api/objects#companyidentity)), più:

  * `foreignOwned` (`boolean | null`) - se l'azienda è a controllo estero.
  * `controllingEntity` (`string | null`) - l'entità controllante, se presente.
</ResponseField>

<ResponseField name="registry" type="object | null">
  Contatti di registro, oppure `null`:

  * `pec` (`string | null`) - indirizzo PEC.
  * `cciaa` (`string | null`) - iscrizione alla Camera di Commercio.
  * `rea` (`string | null`) - numero REA.
</ResponseField>

<ResponseField name="headcount" type="object | null">
  `null`, oppure `{ employees: number, asOf: string }` - numero di dipendenti e la data di riferimento.
</ResponseField>

<ResponseField name="risk" type="RiskIndicators">Flag di rischio. Vedi [RiskIndicators](/it/api/objects#riskindicators).</ResponseField>

<ResponseField name="stateAids" type="object | null">
  Totali degli aiuti di stato, oppure `null`. Campi `count`, `countLast36Months`, `amount`, `amountLast36Months` (ciascuno `number | null`).
</ResponseField>

<ResponseField name="ownership" type="object[]">
  Soci, ciascuno `{ name: string | null, share: number | null }` dove `share` è una quota di proprietà.
</ResponseField>

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

<ResponseField name="latest" type="AnnualSnapshot | null">L'ultimo esercizio di cifre di sintesi. Vedi [AnnualSnapshot](/it/api/objects#annualsnapshot).</ResponseField>
<ResponseField name="financials" type="AnnualSnapshot[]">Esercizi recenti di cifre di sintesi, dal più recente. Vedi [AnnualSnapshot](/it/api/objects#annualsnapshot).</ResponseField>

## Esempio

```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" }
  }
}
```