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

# RUES Entity by NIT

> Resolve a Colombian entity by NIT in RUES and return the full registry record (chamber, status, dates, CIIU activities, addresses, contact, indicators) plus financial statements by year, renewal history, legal representatives and related parties, and registry notices. `found: false` when no exact-NIT match exists.



## OpenAPI

````yaml /api-reference/openapi.json post /co/rues/entity-by-nit/v1
openapi: 3.1.0
info:
  title: Croma Marketplace API
  version: 1.0.0
  description: >-
    Government-data APIs for Colombia, Peru, 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/rues/entity-by-nit/v1:
    post:
      tags:
        - Colombia
        - RUES
      summary: RUES Entity by NIT
      description: >-
        Resolve a Colombian entity by NIT in RUES and return the full registry
        record (chamber, status, dates, CIIU activities, addresses, contact,
        indicators) plus financial statements by year, renewal history, legal
        representatives and related parties, and registry notices. `found:
        false` when no exact-NIT match exists.
      operationId: rues_entity_by_nit
      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: '900654922'
      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/RuesEntityResponse'
        '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://usecroma.com/colombia/rues
components:
  schemas:
    RuesEntityResponse:
      type: object
      required:
        - data
      properties:
        data:
          type: object
          required:
            - found
            - document_number
            - entity
            - financials
            - renewals
            - related_parties
            - notices
          properties:
            found:
              type: boolean
              description: >-
                Whether an exact-NIT entity resolved. When false, entity is null
                and the lists are empty.
            document_number:
              type: string
            entity:
              oneOf:
                - $ref: '#/components/schemas/RuesEntityDetail'
                - type: 'null'
            financials:
              type: array
              items:
                $ref: '#/components/schemas/RuesFinancialYear'
            renewals:
              type: array
              items:
                $ref: '#/components/schemas/RuesRenewal'
            related_parties:
              type: array
              items:
                $ref: '#/components/schemas/RuesRelatedParty'
              description: Legal representatives and other linked parties (see `role`).
            notices:
              type: array
              items:
                $ref: '#/components/schemas/RuesNotice'
    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.
    RuesEntityDetail:
      type: object
      required:
        - registry_id
        - nit
        - verification_digit
        - name
        - chamber_name
        - registration_status
        - registration_date
        - primary_activity
        - commercial_phones
        - fiscal_phones
      properties:
        registry_id:
          type:
            - string
            - 'null'
        nit:
          type:
            - string
            - 'null'
        verification_digit:
          type:
            - string
            - 'null'
        identification_class:
          type:
            - string
            - 'null'
        secondary_identification:
          type:
            - string
            - 'null'
        name:
          type:
            - string
            - 'null'
        acronym:
          type:
            - string
            - 'null'
        chamber_code:
          type:
            - string
            - 'null'
        chamber_name:
          type:
            - string
            - 'null'
        registration_number:
          type:
            - string
            - 'null'
        registration_status:
          type:
            - string
            - 'null'
        registration_category:
          type:
            - string
            - 'null'
        legal_organization:
          type:
            - string
            - 'null'
        society_type:
          type:
            - string
            - 'null'
        society_type_code:
          type:
            - string
            - 'null'
        registration_date:
          type:
            - string
            - 'null'
          format: date
        last_renewal_date:
          type:
            - string
            - 'null'
          format: date
        last_renewed_year:
          type:
            - string
            - 'null'
        expiration_date:
          type:
            - string
            - 'null'
          format: date
        cancellation_date:
          type:
            - string
            - 'null'
          format: date
        cancellation_reason:
          type:
            - string
            - 'null'
        updated_date:
          type:
            - string
            - 'null'
          format: date
        primary_activity:
          $ref: '#/components/schemas/CiiuActivity'
        secondary_activity:
          $ref: '#/components/schemas/CiiuActivity'
        ciiu_3:
          $ref: '#/components/schemas/CiiuActivity'
        ciiu_4:
          $ref: '#/components/schemas/CiiuActivity'
        commercial_address:
          type:
            - string
            - 'null'
        commercial_municipality:
          type:
            - string
            - 'null'
        commercial_phones:
          type: array
          items:
            type: string
        commercial_email:
          type:
            - string
            - 'null'
        fiscal_address:
          type:
            - string
            - 'null'
        fiscal_municipality:
          type:
            - string
            - 'null'
        fiscal_phones:
          type: array
          items:
            type: string
        fiscal_email:
          type:
            - string
            - 'null'
        is_bic:
          type:
            - boolean
            - 'null'
        is_social_enterprise:
          type:
            - boolean
            - 'null'
        is_law_1780:
          type:
            - boolean
            - 'null'
        is_transport:
          type:
            - boolean
            - 'null'
        domain_forfeiture:
          type:
            - boolean
            - 'null'
        sipref_inactivation_control:
          type:
            - boolean
            - 'null'
        certificates_sale_url:
          type:
            - string
            - 'null'
    RuesFinancialYear:
      type: object
      required:
        - year
        - total_assets
        - total_liabilities
        - equity
        - period_result
      description: One year of RUES-reported financial statements (amounts in COP).
      properties:
        year:
          type:
            - string
            - 'null'
        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'
        equity:
          type:
            - number
            - 'null'
        social_balance:
          type:
            - number
            - 'null'
        ordinary_revenue:
          type:
            - number
            - 'null'
        other_income:
          type:
            - number
            - 'null'
        cost_of_sales:
          type:
            - number
            - 'null'
        operating_expenses:
          type:
            - number
            - 'null'
        other_expenses:
          type:
            - number
            - 'null'
        tax_expenses:
          type:
            - number
            - 'null'
        operating_profit:
          type:
            - number
            - 'null'
        period_result:
          type:
            - number
            - 'null'
    RuesRenewal:
      type: object
      required:
        - year
        - renewal_date
      properties:
        year:
          type:
            - string
            - 'null'
        renewal_date:
          type:
            - string
            - 'null'
          format: date
    RuesRelatedParty:
      type: object
      required:
        - document_number
        - name
        - role
      properties:
        document_number:
          type:
            - string
            - 'null'
        name:
          type:
            - string
            - 'null'
        role:
          type:
            - string
            - 'null'
          description: Link type, e.g. "Representante Legal - Principal" / "- Suplente".
    RuesNotice:
      type: object
      required:
        - name
        - act
        - note
        - published_date
        - registered_date
        - chamber_name
      properties:
        name:
          type:
            - string
            - 'null'
        act:
          type:
            - string
            - 'null'
        note:
          type:
            - string
            - 'null'
        published_date:
          type:
            - string
            - 'null'
          format: date
        registered_date:
          type:
            - string
            - 'null'
          format: date
        chamber_name:
          type:
            - string
            - 'null'
    CiiuActivity:
      type: object
      required:
        - code
        - description
      properties:
        code:
          type:
            - string
            - 'null'
        description:
          type:
            - string
            - 'null'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: 'Use Authorization: Bearer YOUR_API_KEY'

````