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

# Reclassified statements

> All six for the same price. Price: 70 credits.



## OpenAPI

````yaml api-reference/openapi.standard.json GET /companies/{id}/reclassified
openapi: 3.1.0
info:
  title: Syrto API - standard endpoints
  version: 1.7.0
  description: >-
    Financial, corporate and market data on Italian companies.


    Every call answers `200 { data, meta }`; `meta.usage.quantity` is what the
    call consumed, in

    credits, and `meta.warnings` lists any non-fatal caveats (empty when there
    are none). Every field

    is always present and unknown values are null. Percentages are fractions
    (0.15 = 15%).


    **Authentication.** Every call needs an API key, sent as `Authorization:
    Bearer sk_...` over

    HTTPS - never in a URL. Keys are scoped to your organization: admins create
    and revoke them in the

    Syrto dashboard (https://dashboard.syrto.ai/api-keys). A missing or
    unrecognised key is a 401

    (`missing_api_key`, `invalid_api_key`); a 503 `auth_unavailable` means the
    key could not be

    checked right now, so retry with backoff rather than rotating it.


    **Billing basis.** negativities, rna and structure bill once per legal
    entity: the individual and

    consolidated records of the same company count once. Every other endpoint
    bills per record (or per

    call), so individual and consolidated count separately. A tax id always
    resolves to a single record

    (`statementBasis`, individual by default): a company is billed twice only
    when both of its

    companyIds are passed. A market call is priced per call, whatever the size
    of its set: omitting

    `filters` and `seedId`, or sending `filters: {}`, is the whole of Italy, at
    the same price.

    notFound entries are never billed, and neither is any error.
servers:
  - url: https://api.syrto.ai
security: []
tags:
  - name: Company data
    description: Identity, risk flags, state aid and branches of known companies.
  - name: Governance
    description: Ownership, officers, beneficial owners and group.
  - name: Financials
    description: Statement items, reclassified statements, indices and spider graph.
  - name: Composite
    description: Comparable companies.
  - name: Search
    description: The companies of a filtered set, row by row.
  - name: Market
    description: Aggregates over a filtered set.
  - name: Catalog
    description: Free reference data.
paths:
  /companies/{id}/reclassified:
    get:
      tags:
        - Financials
      summary: Up to six reclassified statements of one company, as structured rows.
      description: 'All six for the same price. Price: 70 credits.'
      operationId: company-reclassified
      parameters:
        - schema:
            type: string
            minLength: 1
            maxLength: 100
            description: >-
              A companyId (Syrto id of one statement record, starts with `Zm86`)
              or a tax id (11-digit partita IVA or 16-character codice fiscale).
              A tax id resolves to the record selected by `statementBasis`.
            example: '02579690039'
          required: true
          description: >-
            A companyId (Syrto id of one statement record, starts with `Zm86`)
            or a tax id (11-digit partita IVA or 16-character codice fiscale). A
            tax id resolves to the record selected by `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: Comma-separated template slugs; omitted = all six.
          required: false
          description: Comma-separated template slugs; omitted = all six.
          style: form
          explode: false
          name: templates
          in: query
        - schema:
            type: integer
            minimum: 2015
            maximum: 2100
            description: >-
              Financial year (2015-2100). Omitted: the latest filed statement.
              Forecast years are never returned.
          required: false
          description: >-
            Financial year (2015-2100). Omitted: the latest filed statement.
            Forecast years are never returned.
          name: year
          in: query
        - schema:
            type: string
            enum:
              - individual
              - consolidated
            description: >-
              Which statement a tax id resolves to: `individual` (default) is
              the one the company filed for itself, `consolidated` the group's.
              The two can differ by orders of magnitude. Ignored for a
              companyId, which already names one record.
          required: false
          description: >-
            Which statement a tax id resolves to: `individual` (default) is the
            one the company filed for itself, `consolidated` the group's. The
            two can differ by orders of magnitude. Ignored for a companyId,
            which already names one record.
          name: statementBasis
          in: query
        - schema:
            type: string
            enum:
              - it
              - en
            description: >-
              Language of metric names, labels and descriptions (never of field
              names or slugs). Omitted: the account's default.
          required: false
          description: >-
            Language of metric names, labels and descriptions (never of field
            names or slugs). Omitted: the account's default.
          name: language
          in: query
      responses:
        '200':
          description: >-
            Up to six reclassified statements of one company, as structured
            rows.
          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: >-
                Seconds to wait before retrying. Neither a 429 nor a 504 is
                billed. A 504 whose query had reached the data service leaves it
                running, and its answer is cached, so the same call after this
                delay is usually fast.
              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: >-
                Seconds to wait before retrying. Neither a 429 nor a 504 is
                billed. A 504 whose query had reached the data service leaves it
                running, and its answer is cached, so the same call after this
                delay is usually fast.
              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: 'No market benchmark here: the statement generator does not expose one.'
    ResponseMeta:
      type: object
      properties:
        requestId:
          type: string
        endpoint:
          type: string
        usage:
          $ref: '#/components/schemas/Usage'
        warnings:
          type: array
          items:
            $ref: '#/components/schemas/Warning'
          description: Empty when there are none.
      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: >-
            Syrto id of this statement record. Individual and consolidated
            differ.
        legalName:
          type:
            - string
            - 'null'
        taxId:
          type:
            - string
            - 'null'
          description: Codice fiscale / partita IVA.
        consolidated:
          type: boolean
          description: Whether these figures are the consolidated (group) statement.
      required:
        - companyId
        - legalName
        - taxId
        - consolidated
    ReclassifiedStatement:
      type: object
      properties:
        templateSlug:
          $ref: '#/components/schemas/StatementTemplateSlug'
        templateName:
          type: string
          description: Localized.
        year:
          type: integer
        financialStatementDate:
          type:
            - string
            - 'null'
          format: date
          description: >-
            Date of the financial statement the figures come from: the financial
            year end it is made up to (data di chiusura dell'esercizio - 31
            December for most companies, 30 June for a club closing in June).
            Cite it when reporting a discrepancy.
        metricsMatched:
          type: integer
          description: Rows with a value.
        totalSlots:
          type: integer
          description: >-
            Rows the template expects a value for; with metricsMatched, how
            complete it is.
        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: Metric slug of the row; null for heading rows.
        label:
          type: string
          description: Localized row label.
        level:
          type: integer
          minimum: 0
          description: Indentation depth.
        value:
          type:
            - number
            - 'null'
      required:
        - slug
        - label
        - level
        - value
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Org-scoped WorkOS API key (sk_...), sent as `Authorization: Bearer
        <key>`. Admins create and revoke keys in the Syrto dashboard:
        https://dashboard.syrto.ai/api-keys

````

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