RUES

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

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.

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.

Full reference

Schemas, response fields, and an interactive playground.

Get Started

Colombia

Peru

Global

By name

`entities[]`

By NIT

`entity`

`financials[]`

`renewals[]`

`related_parties[]`

`notices[]`

Full reference

​By name

​entities[]

​By NIT

​entity

​financials[]

​renewals[]

​related_parties[]

​notices[]

Full reference

By name

`entities[]`

By NIT

`entity`

`financials[]`

`renewals[]`

`related_parties[]`

`notices[]`