Endpoint: registro mercantil (RUES)

Busca empresas y comerciantes inscritos en las Cámaras de Comercio —el registro que el público consulta como RUES— por documento (NIT o cédula, que es la vía exacta) o por nombre. Devuelve razón social, matrícula, cámara, estado de la matrícula, tipo de sociedad, organización jurídica, códigos CIIU, fechas de matrícula, renovación, vigencia y cancelación, el último año renovado, si está inscrita como proponente y el representante legal con su documento.

POST/api/rues1 crédito

Empresas y comerciantes inscritos en las Cámaras de Comercio (el registro que el público consulta como "RUES"). Se busca por `documento` (NIT o cédula, vía exacta y recomendada) o por `nombre`. Devuelve razón social, matrícula, cámara, **estado de la matrícula**, tipo de sociedad, organización jurídica, códigos CIIU principal y secundario, fechas de matrícula, renovación, vigencia y cancelación, el último año renovado, si está inscrita como proponente y el **representante legal con su documento**. La búsqueda por `nombre` es de **texto completo**: "EL OSO" encuentra también "INVERSIONES ALTAMIRA EL OSO", y los resultados llegan por relevancia. `resumen.totalCoincidencias` es el conteo real en las dos vías. Cuesta 1 crédito, y cero coincidencias es un resultado válido que cobra.

Cuerpo de la solicitud

body (JSON)
{
  "documento": "899999068"
}
Parámetros del cuerpo de la solicitud
CampoTipoQué es
documentostringNIT 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 y buscarlo pegado no encuentra nada. Alias aceptados: `doc`, `nit`.
nombrestringRazón social o cualquier parte de ella: es búsqueda de texto completo, no por prefijo. Mínimo 3 caracteres. Alias aceptado: `razonSocial`.
terminostringCampo único que acepta NIT **o** razón social; se enruta según su contenido (solo dígitos = documento). Existe para migrar desde proveedores que usan un solo campo de búsqueda.
offsetnumberPaginación en filas (0, 50, 100…). Cada página trae hasta 50 registros.
refreshbooleanIgnora la caché y vuelve a consultar la fuente oficial. Ojo: una consulta refrescada con datos siempre cobra (el hit de caché no).

Ejemplos por lenguaje

cURL
curl -X POST 'https://placapi.com/api/rues' \
  -H 'x-api-key: pk_live_TU_CLAVE' \
  -H 'content-type: application/json' \
  -d '{"documento":"899999068"}'
JavaScript (fetch)
const res = await fetch("https://placapi.com/api/rues", {
  method: "POST",
  headers: {
    "x-api-key": "pk_live_TU_CLAVE",
    "content-type": "application/json",
  },
  body: JSON.stringify({"documento":"899999068"}),
});
const data = await res.json();
Python (requests)
import requests

res = requests.post(
    "https://placapi.com/api/rues",
    headers={"x-api-key": "pk_live_TU_CLAVE"},
    json={"documento":"899999068"},
)
data = res.json()

Respuesta exitosa

200 OK — datos ficticios de ejemplo
{
  "source": "registro-mercantil",
  "status": "info",
  "data": {
    "consulta": {
      "documento": "899999068",
      "nombre": ""
    },
    "resumen": {
      "tieneRegistro": true,
      "totalCoincidencias": 1,
      "exacto": true,
      "activas": 1
    },
    "empresas": [
      {
        "razonSocial": "EMPRESA DE EJEMPLO S A",
        "numeroIdentificacion": "899999068",
        "claseIdentificacion": "NIT",
        "digitoVerificacion": "1",
        "matricula": "1291197",
        "camaraComercio": "BOGOTA",
        "estadoMatricula": "ACTIVA",
        "tipoSociedad": "SOCIEDAD COMERCIAL",
        "organizacionJuridica": "SOCIEDAD ANONIMA",
        "categoriaMatricula": "SOCIEDAD ó PERSONA JURIDICA PRINCIPAL ó ESAL",
        "ciiuPrincipal": "0610",
        "ciiuSecundario": "0620",
        "fechaMatricula": "2003-07-18",
        "fechaRenovacion": "2026-03-30",
        "fechaCancelacion": "",
        "fechaVigencia": "2103-07-07",
        "ultimoAnoRenovado": "2026",
        "representanteLegal": "NOMBRE DEL REPRESENTANTE LEGAL",
        "documentoRepresentanteLegal": "19451246",
        "inscritaComoProponente": false
      }
    ],
    "paginacion": {
      "offset": 0,
      "limit": 50,
      "hayMas": false
    }
  },
  "mode": "live",
  "fetchedAt": "2026-07-24T15:04:05.000Z",
  "cost": 1
}

Errores y cobro

Cuesta 1 crédito cuando devuelve datos. Códigos posibles: 400 401 402 404 429 500 502 — qué significa cada uno, cuál reintentar y cuál cobra, en errores y rate limits. Autenticación por x-api-key: cómo generar la clave.

Última revisión: 23 de agosto de 2026 · PlacApi opera desde Colombia. PlacApi no es una entidad oficial del Gobierno.

Contacto