Profilo aziendale

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.

Endpoint di esempio. La sua presenza nella tua API dipende dalla configurazione della tua organizzazione - consulta la tua specifica per gli endpoint predisposti per te.

GET /companies/{taxId}/profile

Parametri di path

string

obbligatorio

Il codice fiscale italiano dell’azienda. Qualsiasi valore non vuoto.

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:

string

L’identificatore interno dell’azienda in Syrto.

CompanyIdentity

Informazioni descrittive dell’azienda. Vedi CompanyIdentity.

AnnualSnapshot | null

L’ultimo esercizio di cifre di sintesi. Vedi AnnualSnapshot.

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

Grandi aziende

number

Il numero di peer comparabili trovati.

object[]

Aziende peer, ciascuna { id: string, identity: CompanyIdentity, latest: AnnualSnapshot | null }.

Aziende più piccole

object

Flag di rischio (vedi RiskIndicators), più:

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

Esempio

Grande azienda (ramo peer):

curl -H "Authorization: Bearer $SYRTO_API_KEY" \
  https://api.syrto.ai/companies/01654010345/profile

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

Per iniziare

Endpoint di esempio

Riferimento interattivo

Riferimento

Profilo aziendale

Parametri di path

Utilizzo

Risposta

Grandi aziende

Aziende più piccole

Esempio

​Parametri di path

​Utilizzo

​Risposta

​Grandi aziende

​Aziende più piccole

​Esempio

Parametri di path

Utilizzo

Risposta

Grandi aziende

Aziende più piccole

Esempio