> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usecroma.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Supersociedades Financial Statements

> Annual financial statements a Colombian company has filed with Supersociedades, by NIT: income statement (revenue, gross/operating/net profit), balance sheet (assets, liabilities, equity) and cash flow per fiscal year, plus the company identity from the filing cover (razón social, status, CIIU, incorporation date). Returns the latest filing per fiscal year, newest first, up to 10 years; figures come as filed, in the unit each filing declares (`reporting_unit`, thousands of COP when declared; older filings declare none). `found: false` when the NIT has no filings on record.



## OpenAPI

````yaml /api-reference/openapi.json post /co/supersociedades/financial-statements/v1
openapi: 3.1.0
info:
  title: Croma Marketplace API
  version: 1.0.0
  description: >-
    Government-data APIs for Colombia, Peru, Mexico, and global web search.
    Croma normalizes public-sector data into structured JSON for product teams
    and AI agents.
servers:
  - url: https://api.croma.run
security: []
paths:
  /co/supersociedades/financial-statements/v1:
    post:
      tags:
        - Colombia
        - Supersociedades
      summary: Supersociedades Financial Statements
      description: >-
        Annual financial statements a Colombian company has filed with
        Supersociedades, by NIT: income statement (revenue, gross/operating/net
        profit), balance sheet (assets, liabilities, equity) and cash flow per
        fiscal year, plus the company identity from the filing cover (razón
        social, status, CIIU, incorporation date). Returns the latest filing per
        fiscal year, newest first, up to 10 years; figures come as filed, in the
        unit each filing declares (`reporting_unit`, thousands of COP when
        declared; older filings declare none). `found: false` when the NIT has
        no filings on record.
      operationId: supersociedades_financial_statements
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - document_number
              properties:
                document_number:
                  type: string
                  minLength: 4
                  maxLength: 15
                  pattern: ^\d{4,15}$
                  description: Colombian NIT (numeric, no verification digit). 4-15 digits.
              additionalProperties: false
            example:
              document_number: '900249127'
      responses:
        '200':
          description: Successful response
          headers:
            X-Request-Id:
              description: >-
                Unique id for the request (req_…). Include it in support
                reports.
              schema:
                type: string
            X-RateLimit-Limit:
              description: Requests allowed in the current window.
              schema:
                type: integer
            X-RateLimit-Remaining:
              description: Requests left before you are throttled.
              schema:
                type: integer
            X-RateLimit-Reset:
              description: ISO 8601 timestamp when the window resets.
              schema:
                type: string
                format: date-time
            X-Cache:
              description: HIT or MISS. Cached hits still count against your quota.
              schema:
                type: string
                enum:
                  - HIT
                  - MISS
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/SupersociedadesFinancialStatementsResponse
        '400':
          description: Invalid request body
          headers:
            X-Request-Id:
              description: >-
                Unique id for the request (req_…). Include it in support
                reports.
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
        '401':
          description: Missing or invalid API key
          headers:
            X-Request-Id:
              description: >-
                Unique id for the request (req_…). Include it in support
                reports.
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
        '429':
          description: Rate limit exceeded
          headers:
            X-Request-Id:
              description: >-
                Unique id for the request (req_…). Include it in support
                reports.
              schema:
                type: string
            X-RateLimit-Limit:
              description: Requests allowed in the current window.
              schema:
                type: integer
            X-RateLimit-Remaining:
              description: Requests left before you are throttled.
              schema:
                type: integer
            X-RateLimit-Reset:
              description: ISO 8601 timestamp when the window resets.
              schema:
                type: string
                format: date-time
            Retry-After:
              description: Seconds to wait before retrying.
              schema:
                type: integer
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
        '500':
          description: Internal error
          headers:
            X-Request-Id:
              description: >-
                Unique id for the request (req_…). Include it in support
                reports.
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
        '502':
          description: Upstream source returned an error
          headers:
            X-Request-Id:
              description: >-
                Unique id for the request (req_…). Include it in support
                reports.
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
      security:
        - bearerAuth: []
      externalDocs:
        description: Interactive documentation and examples
        url: https://docs.usecroma.com/guides/colombia/supersociedades
components:
  schemas:
    SupersociedadesFinancialStatementsResponse:
      type: object
      required:
        - data
      properties:
        data:
          type: object
          required:
            - found
            - document_number
            - company
            - count
            - capped
            - statements
          properties:
            found:
              type: boolean
              description: >-
                False when the NIT has no filings on record; company is then
                null and statements empty.
            document_number:
              type: string
            company:
              oneOf:
                - $ref: '#/components/schemas/SupersociedadesCompanyProfile'
                - type: 'null'
            count:
              type: integer
              description: Fiscal years returned.
            capped:
              type: boolean
              description: True when the result cap was hit; results are then incomplete.
            statements:
              type: array
              items:
                $ref: '#/components/schemas/SupersociedadesStatement'
              description: Latest filing per fiscal year, newest first, up to 10 years.
    ApiError:
      type: object
      required:
        - error
      properties:
        error:
          type: object
          required:
            - type
            - code
            - message
          properties:
            type:
              type: string
              description: >-
                Broad category: invalid_request_error, authentication_error,
                not_found_error, rate_limit_error, upstream_error, api_error.
            code:
              type: string
              description: Machine-readable specific code.
            message:
              type: string
              description: Human-readable explanation, safe to surface in UI.
            param:
              type: string
              description: Field that triggered the error. Present on validation errors.
            details:
              type: object
              description: Free-form structured detail.
    SupersociedadesCompanyProfile:
      type: object
      description: Company identity from the newest filing's cover sheet.
      required:
        - name
        - status
        - society_type
        - primary_activity
        - incorporation_date
        - city
        - department
        - registration_number
      properties:
        name:
          type:
            - string
            - 'null'
        status:
          type:
            - string
            - 'null'
          description: State on the filing cover (e.g. "ACTIVA").
        society_type:
          type:
            - string
            - 'null'
          description: Corporate form (e.g. "08. SOCIEDAD POR ACCIONES SIMPLIFICADA SAS").
        primary_activity:
          $ref: '#/components/schemas/CiiuActivity'
        incorporation_date:
          type:
            - string
            - 'null'
          description: Date of incorporation, yyyy-mm-dd.
        city:
          type:
            - string
            - 'null'
        department:
          type:
            - string
            - 'null'
        registration_number:
          type:
            - string
            - 'null'
          description: Matrícula mercantil.
    SupersociedadesStatement:
      type: object
      description: 'One fiscal year: the chosen filing and its three statements.'
      required:
        - year
        - cutoff_date
        - filing_id
        - statement_type
        - niif_group
        - reporting_unit
        - income_statement
        - balance_sheet
        - cash_flow
      properties:
        year:
          type: integer
        cutoff_date:
          type: string
          description: Fiscal-year cutoff, yyyy-mm-dd (always Dec 31).
        filing_id:
          type: string
        statement_type:
          type:
            - string
            - 'null'
          enum:
            - individual
            - separado
            - consolidado
            - combinado
            - null
          description: >-
            What the filing covers; standalone (individual) filings are
            preferred.
        niif_group:
          type:
            - string
            - 'null'
          enum:
            - plenas
            - pymes
            - null
          description: 'NIIF reporting group: plenas (group 1) or pymes (group 2).'
        reporting_unit:
          type:
            - string
            - 'null'
          description: >-
            Unit the filer declared for every figure ("MILES DE PESOS",
            thousands of COP). Null when the filing declared no unit (fiscal
            years before 2025).
        income_statement:
          oneOf:
            - $ref: '#/components/schemas/SupersociedadesIncomeStatement'
            - type: 'null'
        balance_sheet:
          oneOf:
            - $ref: '#/components/schemas/SupersociedadesBalanceSheet'
            - type: 'null'
        cash_flow:
          oneOf:
            - $ref: '#/components/schemas/SupersociedadesCashFlow'
            - type: 'null'
    CiiuActivity:
      type: object
      required:
        - code
        - description
      properties:
        code:
          type:
            - string
            - 'null'
        description:
          type:
            - string
            - 'null'
    SupersociedadesIncomeStatement:
      type: object
      description: >-
        Income-statement figures as filed, in the filing's reporting_unit.
        Absent concepts are null.
      required:
        - revenue
        - cost_of_sales
        - gross_profit
        - administrative_expenses
        - selling_expenses
        - other_income
        - other_expenses
        - finance_income
        - finance_costs
        - operating_profit
        - profit_before_tax
        - income_tax
        - net_income
      properties:
        revenue:
          type:
            - number
            - 'null'
        cost_of_sales:
          type:
            - number
            - 'null'
        gross_profit:
          type:
            - number
            - 'null'
        administrative_expenses:
          type:
            - number
            - 'null'
        selling_expenses:
          type:
            - number
            - 'null'
        other_income:
          type:
            - number
            - 'null'
        other_expenses:
          type:
            - number
            - 'null'
        finance_income:
          type:
            - number
            - 'null'
        finance_costs:
          type:
            - number
            - 'null'
        operating_profit:
          type:
            - number
            - 'null'
        profit_before_tax:
          type:
            - number
            - 'null'
        income_tax:
          type:
            - number
            - 'null'
        net_income:
          type:
            - number
            - 'null'
    SupersociedadesBalanceSheet:
      type: object
      description: >-
        Balance-sheet figures as filed, in the filing's reporting_unit. Absent
        concepts are null.
      required:
        - current_assets
        - non_current_assets
        - total_assets
        - current_liabilities
        - non_current_liabilities
        - total_liabilities
        - total_equity
        - cash_and_equivalents
        - inventories
        - trade_receivables
        - trade_payables
        - issued_capital
        - retained_earnings
      properties:
        current_assets:
          type:
            - number
            - 'null'
        non_current_assets:
          type:
            - number
            - 'null'
        total_assets:
          type:
            - number
            - 'null'
        current_liabilities:
          type:
            - number
            - 'null'
        non_current_liabilities:
          type:
            - number
            - 'null'
        total_liabilities:
          type:
            - number
            - 'null'
        total_equity:
          type:
            - number
            - 'null'
        cash_and_equivalents:
          type:
            - number
            - 'null'
        inventories:
          type:
            - number
            - 'null'
        trade_receivables:
          type:
            - number
            - 'null'
        trade_payables:
          type:
            - number
            - 'null'
        issued_capital:
          type:
            - number
            - 'null'
        retained_earnings:
          type:
            - number
            - 'null'
    SupersociedadesCashFlow:
      type: object
      description: >-
        Cash-flow figures as filed, in the filing's reporting_unit. Absent
        concepts are null.
      required:
        - net_cash_from_operating
        - net_cash_from_investing
        - net_cash_from_financing
        - cash_at_start
        - cash_at_end
      properties:
        net_cash_from_operating:
          type:
            - number
            - 'null'
        net_cash_from_investing:
          type:
            - number
            - 'null'
        net_cash_from_financing:
          type:
            - number
            - 'null'
        cash_at_start:
          type:
            - number
            - 'null'
        cash_at_end:
          type:
            - number
            - 'null'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: 'Use Authorization: Bearer YOUR_API_KEY'

````