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

# Company profile

> A company profile that adapts to size - peers for large companies, a deeper risk view for smaller ones.

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.

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

## Path parameters

<ParamField path="taxId" type="string" required>
  The company's Italian tax ID (codice fiscale). Any non-empty value.
</ParamField>

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

<ResponseField name="id" type="string">Syrto's internal company identifier.</ResponseField>
<ResponseField name="identity" type="CompanyIdentity">Descriptive company information. See [CompanyIdentity](/api/objects#companyidentity).</ResponseField>
<ResponseField name="latest" type="AnnualSnapshot | null">The latest year of headline figures. See [AnnualSnapshot](/api/objects#annualsnapshot).</ResponseField>

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

### Large companies

<ResponseField name="peerCount" type="number">The number of comparable peers found.</ResponseField>

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

### Smaller companies

<ResponseField name="risk" type="object">
  Risk flags (see [RiskIndicators](/api/objects#riskindicators)), plus:

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

## Example

Large company (peer branch):

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