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

# Profilo aziendale

> Un profilo che si adatta alla dimensione - peer per le grandi aziende, una vista di rischio più approfondita per le più piccole.

Restituisce un profilo di un'azienda. La risposta si adatta alla dimensione dell'azienda: le grandi aziende includono un confronto con i peer, mentre le più piccole includono una vista di rischio più approfondita. Un unico prezzo copre l'intera chiamata a prescindere dal ramo eseguito.

<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/{taxId}/profile
```

## Parametri di path

<ParamField path="taxId" type="string" required>
  Il codice fiscale italiano dell'azienda. Qualsiasi valore non vuoto.
</ParamField>

## Utilizzo

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

## Risposta

L'oggetto `data` contiene sempre questi campi di base:

<ResponseField name="id" type="string">L'identificatore interno dell'azienda in Syrto.</ResponseField>
<ResponseField name="identity" type="CompanyIdentity">Informazioni descrittive dell'azienda. Vedi [CompanyIdentity](/it/api/objects#companyidentity).</ResponseField>
<ResponseField name="latest" type="AnnualSnapshot | null">L'ultimo esercizio di cifre di sintesi. Vedi [AnnualSnapshot](/it/api/objects#annualsnapshot).</ResponseField>

Poi è presente esattamente uno dei rami seguenti, a seconda della dimensione dell'azienda.

### Grandi aziende

<ResponseField name="peerCount" type="number">Il numero di peer comparabili trovati.</ResponseField>

<ResponseField name="peers" type="object[]">
  Aziende peer, ciascuna `{ id: string, identity: CompanyIdentity, latest: AnnualSnapshot | null }`.
</ResponseField>

### Aziende più piccole

<ResponseField name="risk" type="object">
  Flag di rischio (vedi [RiskIndicators](/it/api/objects#riskindicators)), più:

  * `stateAids` (`object | null`) - totali degli aiuti di stato `{ count, amount }`.
  * `history` (`AnnualSnapshot[]`) - esercizi recenti di cifre di sintesi.
</ResponseField>

## Esempio

Grande azienda (ramo peer):

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

```json theme={null}
{
  "data": {
    "id": "Zm86SVRfMDE2NTQwMTAzNDVfVTox",
    "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"
      }
    },
    "latest": {
      "year": 2023,
      "isForecasted": false,
      "size": "L",
      "statementDate": "2023-12-31",
      "employees": 8760,
      "employeesYoY": 0.03
    },
    "peerCount": 2,
    "peers": [
      {
        "id": "Zm86SVRfMDExMjM0NTY3ODlfVToy",
        "identity": {
          "legalName": "PASTIFICIO ESEMPIO S.P.A.",
          "legalForm": "S.p.A.",
          "foundingYear": 1952,
          "incorporationDate": "1952-05-01",
          "isQuoted": false,
          "vatNumber": "01123456789",
          "fiscalCode": "01123456789",
          "naceCode": "10.73",
          "naceSection": "C",
          "address": null
        },
        "latest": {
          "year": 2023,
          "isForecasted": false,
          "size": "L",
          "statementDate": "2023-12-31",
          "employees": 3200,
          "employeesYoY": 0.01
        }
      }
    ]
  },
  "meta": {
    "requestId": "req_018f9c2e7b7a7c3e9a1b2c3d4e5f6a7b",
    "endpoint": "company-profile",
    "usage": { "quantity": 8, "unit": "credits" }
  }
}
```