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

# Bilanci riclassificati

> Tutti e sei allo stesso prezzo. Prezzo: 70 crediti.



## OpenAPI

````yaml api-reference/openapi.standard.it.json GET /companies/{id}/reclassified
openapi: 3.1.0
info:
  title: Syrto API - endpoint standard
  version: 1.7.0
  description: >-
    Dati finanziari, societari e di mercato sulle aziende italiane.


    Ogni chiamata risponde `200 { data, meta }`; `meta.usage.quantity` è quanto
    ha consumato la

    chiamata, in crediti, e `meta.warnings` elenca eventuali avvertenze non
    bloccanti (vuoto quando non

    ce ne sono). Ogni campo è sempre presente e i valori sconosciuti sono null.
    Le percentuali sono

    frazioni (0,15 = 15%).


    **Autenticazione.** Ogni chiamata richiede una chiave API, inviata come
    `Authorization: Bearer sk_...`

    su HTTPS - mai in un URL. Le chiavi sono legate alla tua organizzazione: gli
    admin le creano e le

    revocano nella dashboard Syrto (https://dashboard.syrto.ai/api-keys). Una
    chiave mancante o non

    riconosciuta è un 401 (`missing_api_key`, `invalid_api_key`); un 503
    `auth_unavailable` significa

    che in questo momento non è stato possibile verificare la chiave, quindi
    riprova con backoff invece di

    ruotarla.


    **Base di addebito.** negativities, rna e structure addebitano una volta per
    persona giuridica: il

    record individuale e quello consolidato della stessa azienda contano una
    volta. Ogni altro endpoint

    addebita per record (o per chiamata), quindi individuale e consolidato
    contano separatamente. Un

    codice fiscale si risolve sempre in un solo record (`statementBasis`,
    individuale per impostazione

    predefinita): un'azienda viene addebitata due volte solo se vengono passati
    entrambi i suoi

    companyId. Una chiamata di mercato ha un prezzo per chiamata, qualunque sia
    la dimensione

    dell'insieme: omettere `filters` e `seedId`, o inviare `filters: {}`,
    significa tutta l'Italia, allo

    stesso prezzo. Le voci notFound non vengono mai addebitate, e nemmeno alcun
    errore.
servers:
  - url: https://api.syrto.ai
security: []
tags:
  - name: Company data
    description: Identità, indicatori di rischio, aiuti di Stato e sedi di aziende note.
  - name: Governance
    description: Proprietà, dirigenti, titolari effettivi e gruppo.
  - name: Financials
    description: Voci di bilancio, bilanci riclassificati, indici e grafico spider.
  - name: Composite
    description: Aziende comparabili.
  - name: Search
    description: Le aziende di un insieme filtrato, riga per riga.
  - name: Market
    description: Aggregati su un insieme filtrato.
  - name: Catalog
    description: Dati di riferimento gratuiti.
paths:
  /companies/{id}/reclassified:
    get:
      tags:
        - Financials
      summary: Fino a sei bilanci riclassificati di un'azienda, come righe strutturate.
      description: 'Tutti e sei allo stesso prezzo. Prezzo: 70 crediti.'
      operationId: company-reclassified
      parameters:
        - schema:
            type: string
            minLength: 1
            maxLength: 100
            description: >-
              Un companyId (id Syrto di un record di bilancio, inizia con
              `Zm86`) o un codice fiscale (partita IVA di 11 cifre o codice
              fiscale di 16 caratteri). Un codice fiscale si risolve nel record
              selezionato da `statementBasis`.
            example: '02579690039'
          required: true
          description: >-
            Un companyId (id Syrto di un record di bilancio, inizia con `Zm86`)
            o un codice fiscale (partita IVA di 11 cifre o codice fiscale di 16
            caratteri). Un codice fiscale si risolve nel record selezionato da
            `statementBasis`.
          name: id
          in: path
        - schema:
            type: array
            items:
              type: string
              enum:
                - >-
                  reclassified_balance_sheet_according_to_the_financial_criterion
                - italian_income_statement
                - value_added_income_statement
                - italian_balance_sheet_assets
                - italian_balance_sheet_liabilities
                - cash_flow_statement
            minItems: 1
            maxItems: 6
            description: Slug dei template separati da virgola; omesso = tutti e sei.
          required: false
          description: Slug dei template separati da virgola; omesso = tutti e sei.
          style: form
          explode: false
          name: templates
          in: query
        - schema:
            type: integer
            minimum: 2015
            maximum: 2100
            description: >-
              Esercizio (2015-2100). Omesso: l'ultimo bilancio depositato. Gli
              anni previsionali non vengono mai restituiti.
          required: false
          description: >-
            Esercizio (2015-2100). Omesso: l'ultimo bilancio depositato. Gli
            anni previsionali non vengono mai restituiti.
          name: year
          in: query
        - schema:
            type: string
            enum:
              - individual
              - consolidated
            description: >-
              A quale bilancio si risolve un codice fiscale: `individual`
              (predefinito) è quello che l'azienda ha depositato per sé,
              `consolidated` quello del gruppo. I due possono differire di
              ordini di grandezza. Ignorato per un companyId, che indica già un
              record.
          required: false
          description: >-
            A quale bilancio si risolve un codice fiscale: `individual`
            (predefinito) è quello che l'azienda ha depositato per sé,
            `consolidated` quello del gruppo. I due possono differire di ordini
            di grandezza. Ignorato per un companyId, che indica già un record.
          name: statementBasis
          in: query
        - schema:
            type: string
            enum:
              - it
              - en
            description: >-
              Lingua di nomi, etichette e descrizioni delle metriche (mai dei
              nomi dei campi o degli slug). Omessa: la lingua predefinita
              dell'account.
          required: false
          description: >-
            Lingua di nomi, etichette e descrizioni delle metriche (mai dei nomi
            dei campi o degli slug). Omessa: la lingua predefinita dell'account.
          name: language
          in: query
      responses:
        '200':
          description: >-
            Fino a sei bilanci riclassificati di un'azienda, come righe
            strutturate.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: '#/components/schemas/CompanyReclassified'
                  meta:
                    $ref: '#/components/schemas/ResponseMeta'
                required:
                  - data
                  - meta
        '401':
          description: missing_api_key | invalid_api_key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '402':
          description: credits_exhausted | limit_reached
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: client_not_configured | not_entitled
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: unknown_endpoint | not_found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '422':
          description: invalid_params
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: rate_limited
          headers:
            Retry-After:
              description: >-
                Secondi da attendere prima di riprovare. Né un 429 né un 504
                vengono addebitati. Un 504 la cui query aveva raggiunto il
                servizio dati lo lascia in esecuzione, e la sua risposta viene
                messa in cache, quindi la stessa chiamata dopo questo intervallo
                è di solito veloce.
              schema:
                type: integer
                minimum: 0
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: internal_error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '502':
          description: upstream_error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '503':
          description: auth_unavailable | entitlement_unavailable
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '504':
          description: upstream_timeout
          headers:
            Retry-After:
              description: >-
                Secondi da attendere prima di riprovare. Né un 429 né un 504
                vengono addebitati. Un 504 la cui query aveva raggiunto il
                servizio dati lo lascia in esecuzione, e la sua risposta viene
                messa in cache, quindi la stessa chiamata dopo questo intervallo
                è di solito veloce.
              schema:
                type: integer
                minimum: 0
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
        - bearerAuth: []
components:
  schemas:
    CompanyReclassified:
      allOf:
        - $ref: '#/components/schemas/CompanyHeader'
        - type: object
          properties:
            year:
              type: integer
            statements:
              type: array
              items:
                $ref: '#/components/schemas/ReclassifiedStatement'
          required:
            - year
            - statements
      description: >-
        Nessun benchmark di mercato qui: il generatore dei bilanci non ne espone
        uno.
    ResponseMeta:
      type: object
      properties:
        requestId:
          type: string
        endpoint:
          type: string
        usage:
          $ref: '#/components/schemas/Usage'
        warnings:
          type: array
          items:
            $ref: '#/components/schemas/Warning'
          description: Vuoto quando non ce ne sono.
      required:
        - requestId
        - endpoint
        - usage
        - warnings
    Error:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              enum:
                - missing_api_key
                - invalid_api_key
                - credits_exhausted
                - limit_reached
                - client_not_configured
                - not_entitled
                - unknown_endpoint
                - not_found
                - payload_too_large
                - unsupported_media_type
                - invalid_params
                - rate_limited
                - internal_error
                - upstream_error
                - auth_unavailable
                - entitlement_unavailable
                - upstream_timeout
            message:
              type: string
            requestId:
              type: string
            details:
              type: array
              items:
                type: object
                properties:
                  path:
                    type: string
                  message:
                    type: string
                required:
                  - path
                  - message
          required:
            - code
            - message
            - requestId
      required:
        - error
    CompanyHeader:
      type: object
      properties:
        companyId:
          type: string
          description: >-
            Id Syrto di questo record di bilancio. Individuale e consolidato
            differiscono.
        legalName:
          type:
            - string
            - 'null'
        taxId:
          type:
            - string
            - 'null'
          description: Codice fiscale / partita IVA.
        consolidated:
          type: boolean
          description: >-
            Indica se questi valori provengono dal bilancio consolidato (di
            gruppo).
      required:
        - companyId
        - legalName
        - taxId
        - consolidated
    ReclassifiedStatement:
      type: object
      properties:
        templateSlug:
          $ref: '#/components/schemas/StatementTemplateSlug'
        templateName:
          type: string
          description: Localizzato.
        year:
          type: integer
        financialStatementDate:
          type:
            - string
            - 'null'
          format: date
          description: >-
            Data del bilancio da cui provengono i valori: la data di chiusura
            dell'esercizio (31 dicembre per la maggior parte delle aziende, 30
            giugno per un club con chiusura a giugno). Citala quando segnali una
            discrepanza.
        metricsMatched:
          type: integer
          description: Righe con un valore.
        totalSlots:
          type: integer
          description: >-
            Righe per cui il template prevede un valore; con metricsMatched,
            indica quanto è completo.
        rows:
          type: array
          items:
            $ref: '#/components/schemas/StatementRow'
      required:
        - templateSlug
        - templateName
        - year
        - financialStatementDate
        - metricsMatched
        - totalSlots
        - rows
    Usage:
      type: object
      properties:
        quantity:
          type: number
        unit:
          type: string
      required:
        - quantity
        - unit
    Warning:
      type: object
      properties:
        code:
          type: string
        message:
          type: string
      required:
        - code
        - message
    StatementTemplateSlug:
      type: string
      enum:
        - reclassified_balance_sheet_according_to_the_financial_criterion
        - italian_income_statement
        - value_added_income_statement
        - italian_balance_sheet_assets
        - italian_balance_sheet_liabilities
        - cash_flow_statement
    StatementRow:
      type: object
      properties:
        slug:
          type:
            - string
            - 'null'
          description: Slug della metrica della riga; null per le righe di intestazione.
        label:
          type: string
          description: Etichetta localizzata della riga.
        level:
          type: integer
          minimum: 0
          description: Profondità di indentazione.
        value:
          type:
            - number
            - 'null'
      required:
        - slug
        - label
        - level
        - value
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Chiave API di organizzazione WorkOS (sk_...), inviata come
        `Authorization: Bearer <key>`. Gli admin creano e revocano le chiavi
        nella dashboard Syrto: https://dashboard.syrto.ai/api-keys

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.