> ## 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 report > The most comprehensive report: everything in the credit report plus multi-year financial statements (every reported line item), branches, and beneficial owners and subsidiaries. Billed per call by default. ## OpenAPI ````yaml api-reference/openapi.json GET /companies/{fiscalCode}/report openapi: 3.1.0 info: title: Syrto API (sample) version: 1.0.0 description: >- A sample specification for the Syrto API example endpoints, provided for interactive browsing. Your own API is configured per client - fetch your own schema with your API key to see exactly what your organization can call. servers: - url: https://api.syrto.ai security: - bearerAuth: [] paths: /companies/{fiscalCode}/report: get: summary: Company report description: >- The most comprehensive report: everything in the credit report plus multi-year financial statements (every reported line item), branches, and beneficial owners and subsidiaries. Billed per call by default. operationId: company-report parameters: - name: fiscalCode in: path required: true description: >- An 11-digit tax/VAT code or a 16-character codice fiscale. Case-insensitive. schema: type: string pattern: ^(?:\d{11}|[A-Za-z0-9]{16})$ example: '01654010345' responses: '200': description: The company report. content: application/json: schema: type: object required: - data - meta properties: data: $ref: '#/components/schemas/CompanyReport' meta: $ref: '#/components/schemas/Meta' example: data: 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 activityStartDate: '1877-01-01' dissolutionYear: null 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: shareholders: - name: Barilla Holding S.p.A. share: 0.85 beneficialOwners: - name: Guido Barilla share: 0.28 subsidiaries: - name: Barilla France S.A.S. share: 1 officers: - name: Guido Barilla role: Chairman roleCategory: board branches: - legalName: BARILLA G. E R. FRATELLI - SEDE DI PEDRIGNANO address: line1: Via Emilia line2: null locality: Parma postalCode: '43122' countryCode: IT 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 metrics: - slug: revenues_from_sales_and_services name: Revenues from sales and services categories: - income_statement unit: EUR value: 4200000000 previousValue: 3900000000 yoyChange: 0.077 marketValue: null score: null meta: requestId: req_018f9c2e7b7a7c3e9a1b2c3d4e5f6a7b endpoint: company-report usage: quantity: 1 unit: calls '401': $ref: '#/components/responses/Unauthorized' '404': $ref: '#/components/responses/NotFound' '422': $ref: '#/components/responses/InvalidParams' '429': $ref: '#/components/responses/RateLimited' components: schemas: CompanyReport: type: object properties: isConsolidated: type: boolean latestFiledYear: type: - number - 'null' identity: allOf: - $ref: '#/components/schemas/CompanyIdentity' - type: object properties: activityStartDate: type: - string - 'null' dissolutionYear: type: - number - 'null' foreignOwned: type: - boolean - 'null' controllingEntity: type: - string - 'null' registry: $ref: '#/components/schemas/Registry' headcount: $ref: '#/components/schemas/Headcount' risk: $ref: '#/components/schemas/RiskIndicators' stateAids: $ref: '#/components/schemas/StateAids' ownership: type: object properties: shareholders: type: array items: $ref: '#/components/schemas/Holder' beneficialOwners: type: array items: $ref: '#/components/schemas/Holder' subsidiaries: type: array items: $ref: '#/components/schemas/Holder' officers: type: array items: $ref: '#/components/schemas/Officer' branches: type: array items: $ref: '#/components/schemas/CompanyBranch' latest: anyOf: - $ref: '#/components/schemas/AnnualSnapshot' - type: 'null' financials: type: array items: allOf: - $ref: '#/components/schemas/AnnualSnapshot' - type: object properties: metrics: type: array items: $ref: '#/components/schemas/FinancialMetric' Meta: type: object description: Metadata about the call. required: - requestId - endpoint - usage properties: requestId: type: string description: Unique request id (req_ followed by a UUID). endpoint: type: string description: The endpoint slug that served the request. usage: $ref: '#/components/schemas/Usage' CompanyIdentity: type: object description: Descriptive, non-financial information about a company. properties: legalName: type: - string - 'null' legalForm: type: - string - 'null' foundingYear: type: - number - 'null' incorporationDate: type: - string - 'null' isQuoted: type: - boolean - 'null' vatNumber: type: - string - 'null' fiscalCode: type: - string - 'null' naceCode: type: - string - 'null' naceSection: type: - string - 'null' address: anyOf: - $ref: '#/components/schemas/Address' - type: 'null' Registry: type: - object - 'null' properties: pec: type: - string - 'null' cciaa: type: - string - 'null' rea: type: - string - 'null' Headcount: type: - object - 'null' properties: employees: type: number asOf: type: string RiskIndicators: type: object description: Boolean risk flags; each is true, false, or null when unknown. properties: protestsOfBill: type: - boolean - 'null' insolvencyProceedings: type: - boolean - 'null' insolvencyApplications: type: - boolean - 'null' assetEncumbrances: type: - boolean - 'null' officersWithRiskIndicators: type: - boolean - 'null' StateAids: type: - object - 'null' properties: count: type: - number - 'null' countLast36Months: type: - number - 'null' amount: type: - number - 'null' amountLast36Months: type: - number - 'null' Holder: type: object properties: name: type: - string - 'null' share: type: - number - 'null' description: Ownership fraction. Officer: type: object properties: name: type: - string - 'null' role: type: - string - 'null' roleCategory: type: string CompanyBranch: type: object properties: legalName: type: string address: anyOf: - $ref: '#/components/schemas/Address' - type: 'null' AnnualSnapshot: type: object description: A single fiscal year of headline figures. properties: year: type: number isForecasted: type: boolean size: type: - string - 'null' statementDate: type: - string - 'null' employees: type: - number - 'null' employeesYoY: type: - number - 'null' FinancialMetric: type: object description: A single financial statement line item or metric. properties: slug: type: string name: type: string categories: type: array items: type: string unit: type: - string - 'null' value: type: number previousValue: type: - number - 'null' yoyChange: type: - number - 'null' marketValue: type: - number - 'null' score: type: - number - 'null' Usage: type: object description: The usage measure recorded for the call. required: - quantity - unit properties: quantity: type: number unit: type: string examples: - credits - calls Error: type: object required: - error properties: error: type: object required: - code - message - requestId properties: code: type: string description: Stable, machine-readable error code. enum: - missing_api_key - invalid_api_key - credits_exhausted - limit_reached - client_not_configured - not_entitled - unknown_endpoint - not_found - invalid_params - rate_limited - internal_error - upstream_error - auth_unavailable - entitlement_unavailable - upstream_timeout message: type: string requestId: type: string details: type: array description: Present only for validation failures. items: type: object properties: path: type: string message: type: string Address: type: object properties: line1: type: - string - 'null' line2: type: - string - 'null' locality: type: - string - 'null' postalCode: type: - string - 'null' countryCode: type: string responses: Unauthorized: description: Missing or invalid API key. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: invalid_api_key message: The API key is not recognised. requestId: req_018f9c2e7b7a7c3e9a1b2c3d4e5f6a7b NotFound: description: No company matches the identifier. Not billed. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: not_found message: No company matches that identifier. requestId: req_018f9c2e7b7a7c3e9a1b2c3d4e5f6a7b InvalidParams: description: A path or query parameter failed validation. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: invalid_params message: Invalid request parameters. requestId: req_018f9c2e7b7a7c3e9a1b2c3d4e5f6a7b details: - path: path.fiscalCode message: >- fiscalCode must be an 11-digit tax/VAT code or a 16-character codice fiscale RateLimited: description: Rate limit exceeded. See the Retry-After header. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: rate_limited message: Rate limit exceeded. requestId: req_018f9c2e7b7a7c3e9a1b2c3d4e5f6a7b securitySchemes: bearerAuth: type: http scheme: bearer description: 'Org-scoped API key (sk_...), sent as Authorization: Bearer .' ````