> ## 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 financials > A financial snapshot for a single company: identity, whether its figures are consolidated, and its latest reported year of headline figures. ## OpenAPI ````yaml api-reference/openapi.json GET /companies/{taxId}/financials 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/{taxId}/financials: get: summary: Company financials description: >- A financial snapshot for a single company: identity, whether its figures are consolidated, and its latest reported year of headline figures. operationId: company-financials parameters: - name: taxId in: path required: true description: The company's Italian tax ID (codice fiscale). Any non-empty value. schema: type: string minLength: 1 example: '01654010345' responses: '200': description: The financial snapshot. content: application/json: schema: type: object required: - data - meta properties: data: $ref: '#/components/schemas/CompanyFinancials' 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 latest: year: 2023 isForecasted: false size: L statementDate: '2023-12-31' employees: 8760 employeesYoY: 0.03 meta: requestId: req_018f9c2e7b7a7c3e9a1b2c3d4e5f6a7b endpoint: company-financials usage: quantity: 5 unit: credits '401': $ref: '#/components/responses/Unauthorized' '404': $ref: '#/components/responses/NotFound' '422': $ref: '#/components/responses/InvalidParams' '429': $ref: '#/components/responses/RateLimited' components: schemas: CompanyFinancials: type: object properties: id: type: string isConsolidated: type: boolean latestFiledYear: type: - number - 'null' identity: $ref: '#/components/schemas/CompanyIdentity' latest: anyOf: - $ref: '#/components/schemas/AnnualSnapshot' - type: 'null' 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' 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' 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 .' ````