API de verificación

Verifique hasta 1.000 NIT en una sola llamada. Cada respuesta trae su fecha de corte.

Autenticación

Envíe su clave en la cabecera Authorization. Las claves se guardan cifradas y se muestran una sola vez.

Authorization: Bearer lm_...

POST /v1/verify

Envíe hasta 1.000 NIT en un arreglo. Devolvemos un resultado por cada uno, en el mismo orden.

curl -s https://verificarempresa.com/v1/verify \
  -H 'authorization: Bearer lm_...' \
  -H 'content-type: application/json' \
  -d '{"nits":["901754780","800024140","900.123.456-7"]}'

Aceptamos el NIT como lo tenga guardado: 900123456 o 900.123.456-7. El dígito de verificación se reconoce y se descarta.

Respuesta

{
  "as_of": "2026-08-05T00:00:00.000Z",
  "checked": 3,
  "found": 3,
  "active": 3,
  "results": [
    {
      "nit": "901754780",
      "found": true,
      "verdict": "active",
      "razon_social": "RED INTERNACIONAL DEL CUIDADO",
      "estado_matricula": "ACTIVA",
      "chamber": "Cámara de Comercio de Bogotá",
      "matricula": "90063354",
      "ciiu": "9499",
      "ciiu_label": "Actividades de otras asociaciones n.c.p.",
      "representante_legal": "MILLER ANDRES RODRIGUEZ ZARATE",
      "ultimo_ano_renovado": 2025
    }
  ]
}

Frescura de los datos: as_of y el 503

Cada respuesta incluye as_of, la fecha de corte de los datos. Si nuestros datos superan los 30 días, devolvemos 503 y no respondemos. Preferimos no contestar antes que darle un ACTIVA que no podemos respaldar: usted actuaría sobre él.

HTTP 503
{ "error": "Data is older than the freshness guarantee; refusing to answer.",
  "as_of": "...", "age_days": 41, "max_stale_days": 30 }

Renovación: la señal que otros no dan

En Colombia la matrícula se renueva cada año. El 17% de las empresas que figuran como ACTIVA no renuevan desde antes de 2020. Devolvemos ultimo_ano_renovado para que usted lo vea; un ACTIVA sin renovación reciente no es lo mismo que una empresa al día.

GET /v1/health

Sin clave. Responde qué tan frescos están los datos y si estamos respondiendo.

curl -s https://verificarempresa.com/v1/health

Errores

401

Clave ausente, inválida o revocada.

413

Más de 1.000 NIT en una llamada.

429

Cupo mensual agotado. Se reinicia el día 1.

503

Datos más antiguos que la garantía de frescura. No respondemos.

Cupos

Contamos NIT verificados, no solicitudes. Una consulta de 1.000 empresas consume 1.000 de su cupo, no 1.

Obtener una clave →