---
title: "RUES Entity by NIT"
method: POST
path: "/co/rues/entity-by-nit/v1"
tags: ["Colombia", "RUES"]
---

# RUES Entity by NIT

`POST /co/rues/entity-by-nit/v1`

## Request

- Base URL: `https://api.croma.run`
- URL: `https://api.croma.run/co/rues/entity-by-nit/v1`
- Auth: HTTP bearer

Resolve a Colombian business by NIT and return its full RUES record: registry detail, financial statements, renewal history, related parties and registry notices.

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `document_number` string, required: Colombian NIT (numeric, no verification digit). 4-15 digits.

## Response `200`

Successful response

- RuesEntityResponse
  - `data` RuesEntityData, required
    - `found` boolean, required
    - `document_number` string, required
    - `entity` object, nullable, required
      - `registry_id` string, nullable, required
      - `nit` string, nullable, required
      - `verification_digit` string, nullable, required
      - `identification_class` string, nullable, required
      - `secondary_identification` string, nullable, required
      - `name` string, nullable, required
      - `acronym` string, nullable, required
      - `chamber_code` string, nullable, required
      - `chamber_name` string, nullable, required
      - `registration_number` string, nullable, required
      - `registration_status` string, nullable, required
      - `registration_category` string, nullable, required
      - `legal_organization` string, nullable, required
      - `society_type` string, nullable, required
      - `society_type_code` string, nullable, required
      - `registration_date` string, nullable, required
      - `last_renewal_date` string, nullable, required
      - `last_renewed_year` string, nullable, required
      - `expiration_date` string, nullable, required
      - `cancellation_date` string, nullable, required
      - `cancellation_reason` string, nullable, required
      - `updated_date` string, nullable, required
      - `primary_activity` object, required
        - `code` string, nullable, required
        - `description` string, nullable, required
      - `secondary_activity` object, required
        - `code` string, nullable, required
        - `description` string, nullable, required
      - `ciiu_3` object, required
        - `code` string, nullable, required
        - `description` string, nullable, required
      - `ciiu_4` object, required
        - `code` string, nullable, required
        - `description` string, nullable, required
      - `commercial_address` string, nullable, required
      - `commercial_municipality` string, nullable, required
      - `commercial_phones` string[], required
      - `commercial_email` string, nullable, required
      - `fiscal_address` string, nullable, required
      - `fiscal_municipality` string, nullable, required
      - `fiscal_phones` string[], required
      - `fiscal_email` string, nullable, required
      - `is_bic` boolean, nullable, required
      - `is_social_enterprise` boolean, nullable, required
      - `is_law_1780` boolean, nullable, required
      - `is_transport` boolean, nullable, required
      - `domain_forfeiture` boolean, nullable, required
      - `sipref_inactivation_control` boolean, nullable, required
      - `certificates_sale_url` string, nullable, required
    - `financials` object[], required
      - `year` string, nullable, required
      - `current_assets` number, nullable, required
      - `non_current_assets` number, nullable, required
      - `total_assets` number, nullable, required
      - `current_liabilities` number, nullable, required
      - `non_current_liabilities` number, nullable, required
      - `total_liabilities` number, nullable, required
      - `equity` number, nullable, required
      - `social_balance` number, nullable, required
      - `ordinary_revenue` number, nullable, required
      - `other_income` number, nullable, required
      - `cost_of_sales` number, nullable, required
      - `operating_expenses` number, nullable, required
      - `other_expenses` number, nullable, required
      - `tax_expenses` number, nullable, required
      - `operating_profit` number, nullable, required
      - `period_result` number, nullable, required
    - `renewals` object[], required
      - `year` string, nullable, required
      - `renewal_date` string, nullable, required
    - `related_parties` object[], required
      - `document_number` string, nullable, required
      - `name` string, nullable, required
      - `role` string, nullable, required
    - `notices` object[], required
      - `name` string, nullable, required
      - `act` string, nullable, required
      - `note` string, nullable, required
      - `published_date` string, nullable, required
      - `registered_date` string, nullable, required
      - `chamber_name` string, nullable, required

## Other responses

- `400`: Invalid request body
- `401`: Missing or invalid API key
- `429`: Rate limit exceeded
- `500`: Internal error
- `502`: Upstream source returned an error

---

[API](https://skmtc.dev/usecroma/apis/croma-marketplace-api.md) · [All operations](https://skmtc.dev/usecroma/apis/croma-marketplace-api/llms.txt) · [OpenAPI document](https://skmtc.dev/usecroma/apis/croma-marketplace-api/revisions/df016cdb29d7?raw)