> ## 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. # Credit report > Un credit report completo: dati anagrafici e di registro, indicatori di rischio, organico, aiuti di stato, assetto proprietario e cariche, e diversi esercizi recenti di cifre di sintesi. Assetto proprietario e cariche riportano solo i nomi. ## OpenAPI ````yaml api-reference/openapi.it.json GET /companies/{fiscalCode}/credit-report openapi: 3.1.0 info: title: API Syrto (esempio) version: 1.0.0 description: >- Una specifica di esempio per gli endpoint di esempio dell'API Syrto, fornita per la consultazione interattiva. La tua API è configurata per cliente - scarica la tua specifica con la tua API key per vedere esattamente cosa può chiamare la tua organizzazione. servers: - url: https://api.syrto.ai security: - bearerAuth: [] paths: /companies/{fiscalCode}/credit-report: get: summary: Credit report description: >- Un credit report completo: dati anagrafici e di registro, indicatori di rischio, organico, aiuti di stato, assetto proprietario e cariche, e diversi esercizi recenti di cifre di sintesi. Assetto proprietario e cariche riportano solo i nomi. operationId: company-credit-report parameters: - name: fiscalCode in: path required: true description: >- Un codice fiscale/partita IVA di 11 cifre oppure un codice fiscale di 16 caratteri. Non distingue tra maiuscole e minuscole. schema: type: string pattern: ^(?:\d{11}|[A-Za-z0-9]{16})$ example: '01654010345' responses: '200': description: Il credit report. content: application/json: schema: type: object required: - data - meta properties: data: $ref: '#/components/schemas/CompanyCreditReport' meta: $ref: '#/components/schemas/Meta' example: 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 '401': $ref: '#/components/responses/Unauthorized' '404': $ref: '#/components/responses/NotFound' '422': $ref: '#/components/responses/InvalidParams' '429': $ref: '#/components/responses/RateLimited' components: schemas: CompanyCreditReport: type: object properties: id: type: string isConsolidated: type: boolean latestFiledYear: type: - number - 'null' identity: allOf: - $ref: '#/components/schemas/CompanyIdentity' - type: object properties: 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: array items: $ref: '#/components/schemas/Holder' officers: type: array items: $ref: '#/components/schemas/Officer' latest: anyOf: - $ref: '#/components/schemas/AnnualSnapshot' - type: 'null' financials: type: array items: $ref: '#/components/schemas/AnnualSnapshot' Meta: type: object description: Metadati sulla chiamata. required: - requestId - endpoint - usage properties: requestId: type: string description: Id univoco della richiesta (req_ seguito da un UUID). endpoint: type: string description: Lo slug dell'endpoint che ha servito la richiesta. usage: $ref: '#/components/schemas/Usage' CompanyIdentity: type: object description: Informazioni descrittive, non finanziarie, su un'azienda. 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: Flag di rischio booleani; ciascuno è true, false o null se sconosciuto. 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: Quota di proprietà. Officer: type: object properties: name: type: - string - 'null' role: type: - string - 'null' roleCategory: type: string AnnualSnapshot: type: object description: Un singolo esercizio con le cifre di sintesi. properties: year: type: number isForecasted: type: boolean size: type: - string - 'null' statementDate: type: - string - 'null' employees: type: - number - 'null' employeesYoY: type: - number - 'null' Usage: type: object description: La misura d'uso registrata per la chiamata. 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: Codice di errore stabile e leggibile dalle macchine. 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: Presente solo per gli errori di validazione. 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: API key mancante o non valida. 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: Nessuna azienda corrisponde all'identificatore. Non addebitata. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: not_found message: No company matches that identifier. requestId: req_018f9c2e7b7a7c3e9a1b2c3d4e5f6a7b InvalidParams: description: Un parametro di path o query non ha superato la validazione. 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 superato. Vedi l'header Retry-After. 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: >- API key associata all'organizzazione (sk_...), inviata come Authorization: Bearer . ````