Company profile

Returns a profile for one company. The response adapts to the company’s size: large companies come with a peer comparison, and smaller companies come with a deeper risk view. One price covers the whole call regardless of which branch runs.

Example endpoint. Whether it is part of your API depends on your organization’s configuration - check your schema for the endpoints provisioned for you.

GET /companies/{taxId}/profile

Path parameters

string

required

The company’s Italian tax ID (codice fiscale). Any non-empty value.

Usage

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

Response

The data object always contains these base fields:

string

Syrto’s internal company identifier.

CompanyIdentity

Descriptive company information. See CompanyIdentity.

AnnualSnapshot | null

The latest year of headline figures. See AnnualSnapshot.

Then exactly one of the following branches is present, depending on the company’s size.

Large companies

number

The number of comparable peers found.

object[]

Peer companies, each { id: string, identity: CompanyIdentity, latest: AnnualSnapshot | null }.

Smaller companies

object

Risk flags (see RiskIndicators), plus:

stateAids (object | null) - { count, amount } state aid totals.
history (AnnualSnapshot[]) - recent years of headline figures.

Example

Large company (peer branch):

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

Getting started

Example endpoints

Interactive reference

Reference

Company profile

Path parameters

Usage

Response

Large companies

Smaller companies

Example

​Path parameters

​Usage

​Response

​Large companies

​Smaller companies

​Example

Path parameters

Usage

Response

Large companies

Smaller companies

Example