Credit report

Returns a full credit report for one company: identity and registry data, risk indicators, headcount, state aids, ownership and officers, and several recent years of headline financials. Ownership and officers carry names only, with no other personal identifiers.

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/{fiscalCode}/credit-report

Path parameters

string

required

The company’s Italian fiscal code - either an 11-digit tax/VAT code or a 16-character codice fiscale. Case-insensitive.

Usage

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

Response

The data object contains:

string

Syrto’s internal company identifier.

boolean

Whether the figures come from consolidated financial statements.

number | null

The most recent fiscal year with filed figures.

CompanyIdentity

Descriptive company information (see CompanyIdentity), plus:

foreignOwned (boolean | null) - whether the company is foreign-owned.
controllingEntity (string | null) - the controlling entity, if any.

object | null

Registry contacts, or null:

pec (string | null) - certified email address.
cciaa (string | null) - Chamber of Commerce registration.
rea (string | null) - REA number.

object | null

null, or { employees: number, asOf: string } - employee count and the date it refers to.

RiskIndicators

Risk flags. See RiskIndicators.

object | null

State aid totals, or null. Fields count, countLast36Months, amount, amountLast36Months (each number | null).

object[]

Shareholders, each { name: string | null, share: number | null } where share is an ownership fraction.

object[]

Officers, each { name: string | null, role: string | null, roleCategory: string }.

AnnualSnapshot | null

The latest year of headline figures. See AnnualSnapshot.

AnnualSnapshot[]

Recent years of headline figures, newest first. See AnnualSnapshot.

Example

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

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

Getting started

Example endpoints

Interactive reference

Reference

Credit report

Path parameters

Usage

Response

Example

​Path parameters

​Usage

​Response

​Example

Path parameters

Usage

Response

Example