nvNeuralVerge
Corporate registry

Colombia Company Registry API and MCP — NIT Lookup with Establishments (RUES)

Send a NIT, the Colombian tax ID, or a RUES link, and you get one company record from the Registro Mercantil: name, status, legal form, chamber of commerce, registration number (matrícula), registration and renewal dates, economic activity codes, legal representation and the establishments registered under the company.

You send
a NIT or a registry URL
You get back
Name, status, registration and renewal dates, activities, legal representation and establishments
Coverage
Colombia — entities on RUES (Registro Mercantil).
Price
5 pts — $5 per 1,000
Charged only when the record resolves. A lookup that finds nothing is not billed.
Comparison

Ways to get this data

Three approaches teams use today, and where each one runs into trouble.

ApproachWhat it takesCostTrade-off
RUES (Registro Mercantil) directlyOpen RUES (Registro Mercantil) and read the recordUsually free, sometimes per-documentA different interface, language and data shape for every country you add
Collecting it yourselfBuild and host a crawler per register, then keep each one aliveInfrastructure and maintenanceRegisters change their pages without warning, and nobody is on the hook when yours breaks
NeuralVergeOne request, the same shape as every other source in the catalog$5 per 1,000, misses not billedCovers Colombia — other countries are separate sources with the same request format
Response

What you get back

Every field in the example response below.

FieldTypeDescription
session_idstringId of this run, for tracing.
kindstringAlways "co_company".
companystringThe identifier you sent.
company_idstringThe identifier as the register keys it.
humanstringReadable Markdown summary of the record.
machine.companyobjectThe company record, described below.
machine.blockedbooleanFalse when the register answered normally.
machine.pages_openednumberRegister pages read for this record.
machine.proxy_traffic_bytesnumberData transferred for the run.
total_pointsnumberPoints charged: 5 for a resolved lookup.
machine.company.registration_numberstringNIT with check digit.
machine.company.namestringRegistered name.
machine.company.statusstringRegistration status, for example Activa.
machine.company.addressnullEmpty in the sample.
machine.company.urlstringLink to the record on RUES.
machine.company.company_typestringLegal form, for example SOCIEDAD ANONIMA.
machine.company.incorporation_datestringRegistration date, YYYY-MM-DD.
machine.company.nitstringNIT without the check digit.
machine.company.check_digitstringNIT check digit.
machine.company.acronymnullEmpty in the sample.
machine.company.chamberstringChamber of commerce where the company is registered.
machine.company.matriculastringRegistration number at the chamber.
machine.company.company_classstringClass of registration, for example SOCIEDAD COMERCIAL.
machine.company.registration_categorystringRegistration category as published.
machine.company.activitystringEconomic activities on one line.
machine.company.activitiesarrayActivities as code and description pairs.
machine.company.valid_untilstringDate until which the registration is valid.
machine.company.last_renewal_datestringDate of the last renewal.
machine.company.last_renewed_yearstringYear last renewed.
machine.company.cancellation_datenullCancellation date; null for an active company.
machine.company.cancellation_reasonnullCancellation reason; null for an active company.
machine.company.updated_atstringDate the record was last updated.
machine.company.social_enterprisebooleanSocial-enterprise flag.
machine.company.phonenullEmpty in the sample.
machine.company.emailnullEmpty in the sample.
machine.company.legal_representationstringText describing who represents the company legally.
machine.company.establishmentsarrayEstablishments with name, category, chamber, matricula, registration_date, last_renewal, last_year_renewed and status.
machine.company.establishments_totalnumberTotal establishments.
machine.company.establishments_pages_totalnullEmpty in the sample.
machine.company.establishments_truncatedbooleanWhether the establishments list was cut.
machine.company.legal_representation_truncatedbooleanWhether the legal representation text was cut.
machine.company.chamber_codestringCode of the chamber of commerce.
machine.company.id_typestringType of identifier, NIT in the sample.
machine.company.law_1780_benefitnullEmpty in the sample.
machine.company.bic_companynullEmpty in the sample.
machine.company.transport_indicatornullEmpty in the sample.
machine.company.asset_forfeiturenullEmpty in the sample.
machine.company.ciiu_rev3nullEmpty in the sample.
machine.company.ciiu_rev4nullEmpty in the sample.
Response

Example response

A real response, as returned.

{
  "session_id": "11111111-1111-1111-1111-111111111111",
  "kind": "co_company",
  "company": "899999068-1",
  "company_id": "899999068-1",
  "human": "# Colombia — RUES — company\n\n- **Number:** 899999068-1\n- **Pages opened:** 1\n- **Proxy traffic:** 17.1 KB\n- **Name:** ECOPETROL S A\n- **Status:** Activa\n- **Type:** SOCIEDAD ANONIMA\n- **Registered:** 2003-07-18\n- **Activity:** 0610 Extracción de petróleo crudo; 0620 Extracción de gas natural",
  "machine": {
    "company": {
      "registration_number": "899999068-1",
      "name": "ECOPETROL S A",
      "status": "Activa",
      "address": null,
      "url": "https://www.rues.org.co/buscar/RM/899999068",
      "company_type": "SOCIEDAD ANONIMA",
      "incorporation_date": "2003-07-18",
      "nit": "899999068",
      "check_digit": "1",
      "acronym": null,
      "chamber": "BOGOTA",
      "matricula": "1291197",
      "company_class": "SOCIEDAD COMERCIAL",
      "registration_category": "SOCIEDAD ó PERSONA JURIDICA PRINCIPAL ó ESAL",
      "activity": "0610 Extracción de petróleo crudo; 0620 Extracción de gas natural",
      "activities": [
        {
          "code": "0610",
          "description": "Extracción de petróleo crudo"
        },
        {
          "code": "0620",
          "description": "Extracción de gas natural"
        }
      ],
      "valid_until": "2103-07-07",
      "last_renewal_date": "2026-03-30",
      "last_renewed_year": "2026",
      "cancellation_date": null,
      "cancellation_reason": null,
      "updated_at": "2026-09-21",
      "social_enterprise": false,
      "phone": null,
      "email": null,
      "legal_representation": "El presidente es el representante legal general de la sociedad, quien ejercerá la representación comercial y legal de Ecopetrol para todos los efectos y tendrá, al menos, dos (2) suplentes, quienes lo",
      "establishments": [
        {
          "name": "LA TIENDA ECOPETROL",
          "category": "ESTABLECIMIENTO DE COMERCIO",
          "chamber": "BOGOTA",
          "matricula": "2167505",
          "registration_date": "2012-01-02",
          "last_renewal": "2026-03-30",
          "last_year_renewed": "2026",
          "status": "Activa"
        },
        {
          "name": "LA TIENDA ECOPETROL",
          "category": "ESTABLECIMIENTO DE COMERCIO",
          "chamber": "BOGOTA",
          "matricula": "2456764",
          "registration_date": "2014-05-22",
          "last_renewal": "2026-03-30",
          "last_year_renewed": "2026",
          "status": "Activa"
        }
      ],
      "establishments_total": 4,
      "establishments_pages_total": null,
      "establishments_truncated": false,
      "legal_representation_truncated": false,
      "chamber_code": "04",
      "id_type": "NIT",
      "law_1780_benefit": null,
      "bic_company": null,
      "transport_indicator": null,
      "asset_forfeiture": null,
      "ciiu_rev3": null,
      "ciiu_rev4": null
    },
    "blocked": false,
    "pages_opened": 1,
    "proxy_traffic_bytes": 17464
  },
  "total_points": 5
}
Integration

How to run it

The same lookup works from the app, the API, or as a tool an agent can call mid-task.

One company per request. Pass the registration number or the link to the record on the register.

curl -X POST https://api.neuralverge.ai/functions/v1/run-co-companies \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"company":"899999068-1"}'
Use cases

What teams use it for

Where this field shows up in an actual workflow.

Counterparty verification

Check that a NIT is active and when its registration was last renewed.

Supplier onboarding

Read legal form, chamber and the legal representation text.

Mapping a company's footprint

Use the establishments list to see the shops and branches registered under it.

Spotting lapsed registrations

Compare last_renewal_date and valid_until against today.

Coverage & limits

Coverage, freshness and limits

What this source covers, how fresh it is, and where it stops.

Coverage

Colombia — entities on RUES (Registro Mercantil).

Freshness

Read at request time, so the answer reflects the register as it stands when you ask.

Handling

RUES (Registro Mercantil) is a public register. Every response carries the source URL it was read from and a session id you can trace.

What it will not do
  • —Address, phone and email were null in the sample.
  • —Several flag and code fields (CIIU, benefit and transport indicators) came back null.
  • —Long legal representation text and establishments lists can be truncated; the truncated flags tell you.
FAQ

Questions, answered

The registration number a chamber of commerce assigns in the Registro Mercantil. It is returned with the chamber that issued it.

Related

Related sources

Try colombia company on your own data

One request format across every source in the catalog.

Get started