API REST — acceso por clave
Cómo usar tu clave de acceso
Tu clave rduno_* autentica cada llamada con una cabecera Authorization: Bearer. Es de solo lectura y responde JSON; cada dato trae su fuente oficial y fecha de captura, igual que en la web.
Esta página es para integrarla en tu propio código. Si prefieres consultar empresas sin escribir nada, usa tu área de cliente — misma clave, sin instalar nada.
Autenticación
Todas las rutas bajo /v1/ exigen la cabecera:
Authorization: Bearer rduno_tu_clave_aqui
Una clave inválida o ausente responde 401; superar tu límite de peticiones por minuto responde 429 con Retry-After; superar tu cuota mensual responde 429 hasta el día 1 del mes siguiente. Los tres topes dependen de tu plan — ver precios.
Endpoints principales
GET /v1/empresa/{nit}
Ficha completa: registro mercantil, contratación pública, finanzas y sanciones, con la fuente de cada dato.
curl -H "Authorization: Bearer $CLAVE" https://api.radicadouno.co/v1/empresa/890903938
GET /v1/buscar?q=
Busca por NIT exacto o prefijo de razón social entre las empresas publicables.
curl -H "Authorization: Bearer $CLAVE" "https://api.radicadouno.co/v1/buscar?q=BANCOLOMBIA"
GET /v1/red/{nit}
Empresas que concurren ante los mismos compradores públicos, con similitud normalizada.
curl -H "Authorization: Bearer $CLAVE" https://api.radicadouno.co/v1/red/890903938
GET /v1/entidad/{nit}
Ficha de una entidad compradora: qué proveedores contrata y por cuánto.
curl -H "Authorization: Bearer $CLAVE" https://api.radicadouno.co/v1/entidad/800130907
GET /v1/directorio
El índice de cámaras de comercio, como hub de navegación por el expediente.
curl -H "Authorization: Bearer $CLAVE" https://api.radicadouno.co/v1/directorio
GET /v1/sector/{division}
Empresas de una división CIIU, ordenadas por volumen de contratación.
curl -H "Authorization: Bearer $CLAVE" https://api.radicadouno.co/v1/sector/62
GET /v1/ranking/{dimension}/{clave}
Rankings por año, sector o departamento (dimension = anio | sector | departamento).
curl -H "Authorization: Bearer $CLAVE" https://api.radicadouno.co/v1/ranking/anio/2025
Servidor MCP (plan Business)
Si tu plan es Business, la misma clave abre además el servidor MCP: seis herramientas para que un agente de IA consulte estos datos directamente, en vez de que tu código llame a la API. El plan Pro no incluye el MCP — solo la API REST de esta página.
¿Perdiste tu clave? No se puede recuperar, solo revocar y emitir una nueva — escríbenos desde radicadouno.co/contacto. Condiciones completas en los términos de servicio.