> ## 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 > Look up Colombian entities in RUES by name or NIT: chamber, status, activities, addresses. Resolves entities from RUES (Registro Único Empresarial y Social), Colombia's unified business and social registry maintained by the Confecámaras chambers of commerce. Two lookups: search by name (razón social), or resolve one entity's full record by NIT. ## By name `POST /co/rues/entities-by-name/v1` | Field | Type | Notes | | ------ | ------- | ----------------------------------------------------------- | | `name` | string | **Required.** Entity name (razón social), 3-200 characters. | | `page` | integer | Page number, 10 results per page. Defaults to `1`. | ```bash theme={"dark"} curl https://api.croma.run/co/rues/entities-by-name/v1 \ -H "Authorization: Bearer $CROMA_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "name": "exito" }' ``` Returns `query`, `capped`, `entities[]` (one page of rows, each carrying its full `detail` record), and `pagination` (`total`, `page_size`, `total_pages`, `page`). Results are capped at 500 matches, so when `capped` is `true` the set is incomplete: narrow the name. ### `entities[]` | Field | Notes | | -------------------------------------------- | --------------------------------------------------------------------------- | | `registry_id` | Registro mercantil identifier. | | `nit`, `verification_digit` | NIT and its dígito de verificación. | | `name`, `acronym` | Razón social y sigla. | | `chamber_code`, `chamber_name` | Cámara de comercio. | | `registration_number`, `registration_status` | Matrícula y su estado. | | `legal_organization`, `category` | Organización jurídica y categoría. | | `last_renewed_year` | Último año renovado. | | `document_type` | Tipo de documento. | | `detail` | Full registry record (same fields as the by-NIT `entity` below), or `null`. | ## By NIT `POST /co/rues/entity-by-nit/v1` | Field | Type | Notes | | ----------------- | ------ | ---------------------------------------------------------------- | | `document_number` | string | **Required.** NIT (numeric, no verification digit). 4-15 digits. | ```bash theme={"dark"} curl https://api.croma.run/co/rues/entity-by-nit/v1 \ -H "Authorization: Bearer $CROMA_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "document_number": "900654922" }' ``` Returns `found`, `document_number`, `entity`, and per-entity enrichment: `financials`, `renewals`, `related_parties`, and `notices`. `found` is `false` (with `entity: null` and the lists empty) when no entity matches the NIT exactly. ### `entity` | Field | Notes | | ---------------------------------------------------------------------------------------- | --------------------------------------------------------------- | | `registry_id`, `nit`, `verification_digit` | Ids. | | `identification_class`, `secondary_identification` | Clase y segundo identificador. | | `name`, `acronym` | Razón social y sigla. | | `chamber_code`, `chamber_name` | Cámara de comercio. | | `registration_number`, `registration_status`, `registration_category` | Matrícula, estado, categoría. | | `legal_organization`, `society_type`, `society_type_code` | Organización jurídica y tipo de sociedad. | | `registration_date`, `last_renewal_date`, `last_renewed_year` | Fechas de matrícula y renovación. | | `expiration_date`, `cancellation_date`, `cancellation_reason`, `updated_date` | Vigencia, cancelación, actualización. | | `primary_activity`, `secondary_activity`, `ciiu_3`, `ciiu_4` | CIIU activities, each `{ code, description }`. | | `commercial_address`, `commercial_municipality`, `commercial_phones`, `commercial_email` | Datos comerciales. | | `fiscal_address`, `fiscal_municipality`, `fiscal_phones`, `fiscal_email` | Datos fiscales. | | `is_bic`, `is_social_enterprise`, `is_law_1780`, `is_transport` | Indicadores (BIC, emprendimiento social, Ley 1780, transporte). | | `domain_forfeiture`, `sipref_inactivation_control` | Extinción de dominio, control SIPREF. | | `certificates_sale_url` | URL de venta de certificados. | Dates are `yyyy-mm-dd`; unavailable values are `null`, and indicator fields are booleans. ### `financials[]` Financial statements by year (amounts in COP). | Field | Notes | | ----------------------------------------------------------------------- | --------------------------------------------- | | `year` | Año de la información financiera. | | `current_assets`, `non_current_assets`, `total_assets` | Activos. | | `current_liabilities`, `non_current_liabilities`, `total_liabilities` | Pasivos. | | `equity`, `social_balance` | Patrimonio. | | `ordinary_revenue`, `other_income` | Ingresos. | | `cost_of_sales`, `operating_expenses`, `other_expenses`, `tax_expenses` | Costos y gastos. | | `operating_profit`, `period_result` | Utilidad operacional y resultado del periodo. | ### `renewals[]` | Field | Notes | | -------------- | -------------------- | | `year` | Año renovado. | | `renewal_date` | Fecha de renovación. | ### `related_parties[]` Legal representatives and other linked parties. | Field | Notes | | ------------------------- | ---------------------------------------------------------- | | `document_number`, `name` | Documento y nombre del vinculado. | | `role` | Tipo de vínculo, e.g. `"Representante Legal - Principal"`. | ### `notices[]` Registry notices (noticias mercantiles). | Field | Notes | | ----------------------------------- | ------------------------------------------------- | | `name` | Razón social. | | `act`, `note` | Acto (e.g. `"RENOVACIÓN"`) y texto de la noticia. | | `published_date`, `registered_date` | Fechas. | | `chamber_name` | Cámara. | Schemas, response fields, and an interactive playground.