RUES Colombia Company Registry & NIT Scraper

Here is one real result, with every field the actor returns:

{
  "razonSocial": "SOLUCIONES CON EXITO LIMITADA - EN LIQUIDACION",
  "nit": "830133224",
  "numeroIdentificacion": "00000830133224",
  "digitoVerificacion": "5",
  "estado": "ACTIVA",
  "tipoEntidad": "SOCIEDAD LIMITADA",
  "camara": "BOGOTA",
  "matricula": "0001331225",
  "fechaMatricula": "2004-01-13",
  "municipio": "BOGOTA, D.C.",
  "departamento": "BOGOTA",
  "ciiu": "8299",
  "id": "40001331225",
  "url": "https://www.rues.org.co/RM/40001331225",
  "sigla": "SOLUEXITO LTDA",
  "categoria": "SOCIEDAD ó PERSONA JURIDICA PRINCIPAL ó ESAL",
  "tipoSociedad": "SOCIEDAD COMERCIAL",
  "organizacionJuridica": "SOCIEDAD LIMITADA",
  "ciiuDescripcion": "Otras actividades de servicio de apoyo a las empresas n.c.p.",
  "ciiuSecundario": "4799",
  "ciiuSecundarioDescripcion": "Otros tipos de comercio al por menor no realizado en establecimientos, puestos de venta o mercados",
  "ciiu3": "4742",
  "ciiu3Descripcion": "Comercio al por menor de equipos y aparatos de sonido y de video, en establecimientos especializados",
  "ciiu4": "4610",
  "ciiu4Descripcion": "Comercio al por mayor a cambio de una retribución o por contrata",
  "fechaRenovacion": "2023-03-17",
  "ultimoAnoRenovado": "2023",
  "fechaVigencia": "2024-01-05",
  "fechaCancelacion": null,
  "motivoCancelacion": null,
  "fechaActualizacion": "2025-02-05",
  "emprendimientoSocial": false,
  "extincionDominio": null,
  "urlVentaCertificados": "https://www.ccb.org.co/Tramites-y-Consultas/Mas-informacion/Certificados-electronicos/",
  "observedAt": "2026-08-10T14:38:53.904Z",
  "error": null
}

The most complete RUES Colombia registry scraper available. It returns every field the registry exposes for a company, from razonSocial, NIT and estado to the chamber of commerce, matricula, up to four CIIU activity codes with descriptions, renewal and validity dates, and municipality and department, and searches by legal name or NIT with no login or API key.

📥 Input · 📤 Output · 💰 Pricing · ▶️ Examples

Table of contents

• What it does
• Quickstart
• Input reference
• Output reference
• Example output record
• Run via API and CLI
• Fetch results
• Billing and limits
• FAQ and troubleshooting

What it does

The actor searches the Colombian RUES registry for each term you pass, treating numeric terms as NIT lookups and text terms as legal-name searches, filters by registration status, and writes one normalized record per company to the run's dataset. With withDetails on (the default), it also fetches each company's full registry record, adding the sigla, category, society type, up to four CIIU activity codes with descriptions, renewal, validity and update dates, and cancellation details. Choose between the Registro Mercantil (companies) and ESAL (non-profits) registries.

Data covers companies and non-profits registered in Colombia through RUES. No login or API key is required.

Quickstart

Open the actor, paste this into the input, and press Run. It searches active companies matching "exito" with full details.

{
  "maxCompanies": 10,
  "withDetails": true,
  "searchTerms": ["exito"],
  "register": "RM",
  "status": ["ACTIVA"]
}

Pass a NIT such as 830133224 to look up one company by tax ID, or a legal name to search by name. Set register to ESAL for non-profits, and adjust status to include cancelled or inactive records.

Input reference

Field	Type	Required	Default	Description
searchTerms	string[]	no	["exito"]	Company names or NIT tax-IDs to search. Numeric terms are treated as NIT searches; text terms search by legal name. Add one or more.
maxCompanies	integer	no	10	Maximum companies to collect across all search terms. Range 1 to 1000000.
withDetails	boolean	no	true	When on, also fetch each company's full registry record (address, secondary activities, renewal and validity dates). Slower but richer.
register	enum	no	RM	Which registry to search: RM (Registro Mercantil, companies and merchants) or ESAL (Entidades Sin Ánimo de Lucro, non-profits and foundations).
status	string[]	no	["ACTIVA"]	Filter by merchant registration status. Any of ACTIVA (active), CANCELADA (cancelled), NO ACTIVA (inactive). Defaults to active only.

Output reference

One dataset item per company. Types: string, boolean, or null when the source value is absent. Fields marked (details) are only populated when withDetails is on.

Field	Type	Description
razonSocial	string	Legal company name.
nit	string	NIT tax identification number.
numeroIdentificacion	string	Zero-padded identification number.
digitoVerificacion	string	NIT verification digit.
estado	string	Registration status, for example ACTIVA.
tipoEntidad	string	Entity type, for example SOCIEDAD LIMITADA.
camara	string	Chamber of commerce.
matricula	string	Mercantile registration (matricula) number.
fechaMatricula	string	Registration date (YYYY-MM-DD).
municipio	string	Municipality.
departamento	string	Department.
ciiu	string	Primary CIIU activity code.
id	string	RUES internal record ID.
url	string	RUES record URL.
sigla	string	Short name / acronym (details), or null.
categoria	string	Entity category (details), or null.
tipoSociedad	string	Society type (details), or null.
organizacionJuridica	string	Legal organization form (details), or null.
ciiuDescripcion	string	Description of the primary CIIU code (details).
ciiuSecundario	string	Secondary CIIU code (details), or null.
ciiuSecundarioDescripcion	string	Description of the secondary CIIU code (details).
ciiu3	string	Third CIIU code (details), or null.
ciiu3Descripcion	string	Description of the third CIIU code (details).
ciiu4	string	Fourth CIIU code (details), or null.
ciiu4Descripcion	string	Description of the fourth CIIU code (details).
fechaRenovacion	string	Last renewal date (details), or null.
ultimoAnoRenovado	string	Last renewed year (details), or null.
fechaVigencia	string	Validity date (details), or null.
fechaCancelacion	string	Cancellation date (details), or null.
motivoCancelacion	string	Cancellation reason (details), or null.
fechaActualizacion	string	Last update date (details), or null.
emprendimientoSocial	boolean	Whether flagged as a social enterprise (details).
extincionDominio	string	Asset-forfeiture flag (details), or null.
urlVentaCertificados	string	URL to buy official certificates (details), or null.
observedAt	string	ISO 8601 timestamp of when the record was collected.
error	string	null on success. On a failed item, a populated error instead.

Example output record

Real record from a live run (input {"searchTerms":["exito"],"withDetails":true,"status":["ACTIVA"]}):

{
  "razonSocial": "SOLUCIONES CON EXITO LIMITADA - EN LIQUIDACION",
  "nit": "830133224",
  "digitoVerificacion": "5",
  "estado": "ACTIVA",
  "tipoEntidad": "SOCIEDAD LIMITADA",
  "camara": "BOGOTA",
  "matricula": "0001331225",
  "fechaMatricula": "2004-01-13",
  "municipio": "BOGOTA, D.C.",
  "departamento": "BOGOTA",
  "ciiu": "8299",
  "ciiuDescripcion": "Otras actividades de servicio de apoyo a las empresas n.c.p.",
  "url": "https://www.rues.org.co/RM/40001331225",
  "fechaRenovacion": "2023-03-17",
  "fechaVigencia": "2024-01-05",
  "fechaActualizacion": "2025-02-05",
  "observedAt": "2026-08-10T14:38:53.904Z",
  "error": null
}

Run via API and CLI

Start a run and wait for it to finish, then read the dataset. Replace <TOKEN> with your Apify API token.

Run synchronously and get dataset items in one call:

curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~rues-scraper/run-sync-get-dataset-items?token=<TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"searchTerms":["830133224"],"withDetails":true}'

Start a run asynchronously:

curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~rues-scraper/runs?token=<TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"searchTerms":["fundacion"],"register":"ESAL","maxCompanies":100}'

Apify CLI:

apify call scrapers_lat/rues-scraper \
  --input '{"searchTerms":["exito"]}'

Fetch results

Every run writes to a dataset. Fetch items as JSON, CSV, or Excel by changing format:

# JSON
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&clean=true&format=json"

# CSV
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&clean=true&format=csv"

# Paginate large datasets
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&offset=1000&limit=1000"

<DATASET_ID> is returned as defaultDatasetId in the run object. Use offset and limit to page through large result sets. clean=true drops empty and internal fields.

Billing and limits

• Pay per result. You are charged per company returned (result event). See the pricing tab for the current per-result price.
• No charge on failure. Searches that match no company do not push billable records, so empty runs cost nothing.
• Spend cap respected. Set maxTotalChargeUsd on the run; once reached, the actor stops emitting and charging further billable results.
• Free Apify plans are capped at 10 companies per run. Upgrade for higher maxCompanies.
• Detail fetches add a page request per company. Turn withDetails off for faster, lighter runs when you only need the core fields.

FAQ and troubleshooting

A search returned 0 records. Why? The name or NIT matched nothing under the chosen register and status. Try a broader name, confirm the NIT, add CANCELADA or NO ACTIVA to status, or switch register. Zero-result runs are not charged.

How do I look up a company by tax ID? Put the NIT (numeric) in searchTerms. Numeric terms are treated as NIT lookups automatically.

What is the difference between RM and ESAL? RM is the Registro Mercantil for companies and merchants. ESAL is the register of non-profits, foundations and NGOs. Set register to the one you need.

What do the CIIU fields mean? ciiu is the primary economic activity code, with ciiuDescripcion describing it. ciiuSecundario, ciiu3, and ciiu4 are additional activities, each with a matching description field, populated when the company registers more than one activity.

Why turn withDetails off? With details off, the actor returns only the core search fields and skips the per-company detail page, making runs faster and cheaper when you do not need renewal dates or secondary activities.

Is this an official RUES tool? No. This actor is independent and has no affiliation with RUES or the chambers of commerce. It reads only publicly available registry data. Use it in accordance with the source's terms.

Related scrapers

• Colombia Company Financials Scraper: financial statements for Colombian companies.
• Colombia SECOP Scraper: Colombian public procurement contracts.
• Colombia Rama Judicial Scraper: Colombian court case records.
• Chile Companies Registry Scraper: Chilean company registry data.
• Argentina Companies Scraper: Argentine company registry data.
• Brazil CNPJ Scraper: Brazilian company registry data.

More scrapers at scrapers.lat

Built and maintained by scrapers.lat, where we publish scrapers for US and Latin American public platforms: company registries, government data, finance, e-commerce and more. Browse the catalog or request a custom scraper at scrapers.lat.

---

Independent tool, not affiliated with RUES or the Colombian chambers of commerce. Accesses only publicly available registry data. Use in accordance with the source's terms of service.