Prometiam es una API REST con datos de los registros oficiales de empresas de 27 países. Para Colombia recibe, en un solo objeto JSON, los datos del registro mercantil (RUES, Confecámaras): NIT con su dígito de verificación, razón social, tipo de sociedad, estado y actividad económica.
Cuando una empresa colombiana se registra como cliente o como proveedor, el equipo de cumplimiento, compras o finanzas suele hacer lo mismo: buscar el NIT en el RUES o en una cámara de comercio, copiar a mano la razón social y el estado, y archivar una captura. Con la API esa verificación es una llamada HTTP que puede integrarse en el vinculación de clientes, en el alta de proveedores o en la conciliación de facturas, y que devuelve el mismo formato que las consultas de los otros 26 países.
Usted envía el NIT, con o sin el dígito de verificación, y recibe la sociedad con su estado normalizado. Los datos provienen del extracto del RUES en el portal de datos abiertos de Colombia, se actualizan cada día hábil y la fecha de la fuente está en data_as_of. Para entender el registro, lea qué es el RUES; para comprobar un NIT sin cuenta, use la herramienta de consulta de NIT.
La búsqueda por NIT es una sola llamada GET. Los ejemplos usan el NIT de Rappi S.A.S., 900843898-9; la respuesta trae una lista en data.
curl 'https://api.prometiam.com/functions/v1/risk-api/companies/search?country=CO&company_number=900843898-9' \ -H 'Authorization: Bearer rk_live_...'
import requests
BASE = 'https://api.prometiam.com/functions/v1/risk-api'
H = {'Authorization': 'Bearer rk_live_...'}
r = requests.get(f'{BASE}/companies/search', headers=H,
params={'country': 'CO', 'company_number': '900843898-9'})
empresa = r.json()['data'][0]
print(empresa['company_name'], empresa['status'], empresa['registry_details']['last_renewal_year'])
¿No conoce el NIT? Busque por nombre con name= en lugar de company_number=. Si pasa un dígito de verificación, debe coincidir: un dígito equivocado devuelve un error 400 validation_error.
| Campo | Qué significa |
|---|---|
company_number | NIT con su dígito de verificación, por ejemplo 900843898-9 |
company_name | Razón social sin las marcas de estado; registry_details.name_as_registered conserva el nombre publicado |
status y local_status | Estado normalizado (activa, cancelada, en liquidación, en reorganización) y el texto del registro |
legal_form | Tipo de sociedad: S.A.S., Ltda., S.A., en comandita, sucursal de sociedad extranjera |
activity_code | Código CIIU Rev. 4 A.C. de 4 dígitos, con el esquema CO-CIIU-REV4-AC |
registry_details.last_renewal_year | Último año en que se renovó la matrícula |
region | Departamento de la cámara de comercio; el registro no publica dirección |
Para Colombia existen eventos de cambio del registro (nombre, estado y tipo de sociedad). Cada evento se fecha el día en que el cambio aparece por primera vez en los datos del registro, y no hay eventos anteriores a la primera carga, en octubre de 2026. Con POST /monitor recibe un webhook cuando cambia el estado, cuando se cancela la matrícula, cuando hay una coincidencia con listas de sanciones (en beta) y cuando aparece un evento del registro.
vat= se rechaza.CO-CIIU-REV4-AC), de 4 dígitos, no la NACE.La prueba gratuita dura 14 días e incluye 500 créditos; se requiere una tarjeta, pero no se cobra nada durante la prueba. Después, el plan Starter cuesta € 9,99 al mes con 1.000 créditos, el Professional € 29,99 con 10.000 y el Scale € 99,99 con 50.000; el Enterprise tiene un precio a la medida. Consultar el registro de una empresa cuesta 1 crédito, unos € 0,01 en Starter y desde € 0,002 en Scale. Los precios son públicos y el plan anual incluye dos meses sin costo.
Contains data from Confecámaras (Registro Único Empresarial y Social, RUES), via the Portal de Datos Abiertos www.datos.gov.co, licensed CC BY-SA 4.0 (https://creativecommons.org/licenses/by-sa/4.0/). Modified by Prometiam; the Colombian records are offered under CC BY-SA 4.0. Los registros colombianos se ofrecen bajo la licencia CC BY-SA 4.0 (con compartir igual): puede copiarlos, reutilizarlos y redistribuirlos, también con fines comerciales, citando la fuente y manteniendo la misma licencia.
Empezar la prueba gratuita de 14 días · Documentación de la API
La prueba dura 14 días e incluye 500 créditos. Se requiere una tarjeta; durante la prueba no se cobra nada y después se aplica el plan Starter (9,99 € al mes), salvo que cancele.