API del RUES en Colombia: registro mercantil y matrícula por NIT

Qué problema resuelve

Verificar que una empresa existe, está activa y renovó su matrícula es el primer paso de cualquier contrato, y hoy exige entrar al portal del RUES a mano, una empresa a la vez. Su buscador está detrás de una aplicación de navegador que no se puede consumir desde un servidor. Este endpoint entrega el mismo registro como REST, y además devuelve campos que el buscador público no muestra: el dígito de verificación del NIT y el representante legal con su número de documento.

Para quién sirve

Áreas de compras y proveedores que validan una contraparte antes de firmar, fintechs que originan crédito empresarial, plataformas B2B que verifican al vendedor durante el registro, y equipos de cumplimiento que arman expedientes de debida diligencia.

Datos requeridos

• documento — NIT o cédula del inscrito. Se acepta con puntos y con el dígito de verificación (900123456-7): se normaliza y el dígito se descarta, porque el registro lo guarda en una columna aparte.
• nombre — alternativa al documento: la razón social o cualquier parte de ella. Es búsqueda de texto completo.
• offset — opcional, para paginar de 50 en 50.

Fuentes y cobertura

• Registro mercantil de las Cámaras de Comercio (Confecámaras)Extracción oficial del registro de personas naturales, jurídicas y entidades sin ánimo de lucro: matrícula, cámara, estado, tipo de sociedad, organización jurídica, categoría, CIIU y representante legal.

¿Cómo consultar el RUES por NIT desde una aplicación?

Con una llamada POST a /api/rues enviando el campo documento con el NIT sin el dígito de verificación. La respuesta llega en JSON con la razón social, la matrícula, la cámara de comercio y el estado de la matrícula. También se acepta el NIT con puntos y con dígito (900.123.456-7): se normaliza antes de consultar.

¿Cómo saber si una empresa está activa en Colombia?

El campo estadoMatricula responde eso: ACTIVA o CANCELADA. Conviene leerlo junto con ultimoAnoRenovado, porque una matrícula activa que lleva varios años sin renovar no es lo mismo que una al día.

Ejemplo de solicitud

POST https://placapi.com/api/rues. Autenticación por API key en el header x-api-key. Los datos del ejemplo son ficticios.

curl -X POST 'https://placapi.com/api/rues' \
  -H 'x-api-key: pk_live_TU_CLAVE' \
  -H 'content-type: application/json' \
  -d '{"documento":"899999068"}'

Ejemplo de respuesta

Respuesta JSON (fragmento con los campos de esta consulta; la API integral devuelve todas las fuentes en el mismo objeto).

{
  "source": "registro-mercantil",
  "status": "info",
  "data": {
    "resumen": {
      "tieneRegistro": true,
      "totalCoincidencias": 1,
      "exacto": true,
      "activas": 1
    },
    "empresas": [
      {
        "razonSocial": "EMPRESA DE EJEMPLO S A",
        "numeroIdentificacion": "899999068",
        "digitoVerificacion": "1",
        "matricula": "1291197",
        "camaraComercio": "BOGOTA",
        "estadoMatricula": "ACTIVA",
        "tipoSociedad": "SOCIEDAD COMERCIAL",
        "ciiuPrincipal": "0610",
        "fechaMatricula": "2003-07-18",
        "ultimoAnoRenovado": "2026",
        "representanteLegal": "NOMBRE DEL REPRESENTANTE LEGAL",
        "inscritaComoProponente": false
      }
    ]
  }
}

Explicación campo por campo

Limitaciones y posibles errores

• La búsqueda por nombre ordena por relevancia, no alfabéticamente: la coincidencia más parecida va primero. Si buscas una empresa concreta y tienes el NIT, esa vía es exacta.
• La fuente publica el CÓDIGO CIIU pero no su descripción. No la inventamos para no arriesgar una etiqueta equivocada.
• El registro se actualiza por lotes, no en tiempo real: una matrícula tramitada hoy puede tardar en aparecer.

Códigos de error del endpoint (401, 402, 429, 5xx) en la referencia de errores.

Otras preguntas frecuentes

Seguir explorando

• API del SECOP II: contratos con el Estado→
• API de procesos judiciales→
• API de bienes y rentas→
• API de antecedentes judiciales→
• Documentación e integración→
• API de verificación de identidad: las once consultas→