API de verificación KYB — empresas UE + RU en 30 líneas

Esta página muestra cómo construir un flujo de alta KYB (Know Your Business) para empresas de la UE y Reino Unido con la API de Prometiam. Dar de alta a una contraparte B2B en un entorno regulado exige demostrar que la empresa existe legalmente, saber quién la controla y comprobar su exposición a sanciones. En lugar de combinar proveedores distintos para datos españoles, franceses, británicos, irlandeses, polacos y noruegos más un proveedor de sanciones aparte, Prometiam cubre la parte registral y la de sanciones con un único conjunto de endpoints REST y precios por consumo.

La integración en tres pasos

Tres endpoints cubren el flujo, en este orden: resolver la contraparte con /companies/search por NIF (España), SIREN (Francia) o company_number (Reino Unido); obtener la ficha completa con /companies/{id}; y cribar la persona jurídica y cada administrador vigente con /sanctions/screen. La página incluye un ejemplo en Python de unas 30 líneas que devuelve un veredicto de verificado o a revisar.

Qué te devuelve

  • Identidad: denominación social, NIF/SIREN/company_number, forma jurídica, domicilio, fecha de constitución
  • Coordenadas registrales (tomo/libro/folio/hoja en España, oficina de registro en Francia, número de Companies House en Reino Unido)
  • Administradores vigentes e históricos, y estado actualizado a diario
  • Capital social y objeto social

El cribado de sanciones compara nombres contra seis fuentes — UE, ONU, OFAC, OFSI británica, el Registro francés de congelaciones y la US Consolidated Screening List (BIS Entity List, Denied Persons, ITAR) — más de 44.000 entidades activas, con puntuación de confianza y un umbral configurable. El cribado PEP está en beta y solo cubre España (sin familiares ni allegados); no hay cribado de reputación adversa ni verificación de identidad de personas físicas. La titularidad real solo está disponible para Reino Unido vía PSC; Irlanda y Polonia son a nivel empresa. El BORME y el BODACC se actualizan a diario; Companies House es descarga mensual más incrementos diarios.

Leer más · Conseguir una clave API gratis

Frequently asked questions

¿Qué es KYB?
Know Your Business: el proceso regulado de verificar una contraparte empresarial antes de operar con ella. Normalmente exige confirmar la existencia legal (registro mercantil), la titularidad real, la exposición a sanciones y la reputación adversa. La API de Prometiam cubre las partes de registro y sanciones en un mismo conjunto de endpoints.
¿Qué países cubre el KYB de Prometiam?
España (BORME), Francia (BODACC), Reino Unido (Companies House), Irlanda (CRO, a nivel empresa), Polonia (KRS, a nivel empresa) y Noruega (Brønnøysundregistrene, empresas y administradores). Se usa ?country=ES|FR|GB|IE|PL|NO en cada endpoint.
¿Qué tan rápido se integra?
La primera llamada de KYB con éxito suele lograrse en menos de 60 segundos desde el alta. El patrón es: /companies/search para resolver, /companies/{id} para el detalle, /sanctions/screen para el cribado — todo con autenticación Bearer.
¿Incluye titularidad real (UBO)?
Para empresas del Reino Unido, sí, vía PSC (Persons with Significant Control), incluido en /companies/{id} y /people/{id}. Para España y Francia exponemos lo que consta en el registro mercantil que consultamos, pero la cadena completa de titularidad real exige consultar el registro nacional correspondiente (el RBR español, el RBE francés), que todavía no exponemos.
¿Cómo se compara el KYB de Prometiam con Creditsafe o Iberinform?
Para el alcance UE + RU, normalmente entre un 50 % y un 95 % más barato en escala pyme y mid-market. Creditsafe e Iberinform también funcionan, pero exigen contacto comercial y contrato anual. Ver /es/alternativas/creditsafe y /es/alternativas/iberinform.
¿Los datos son lo bastante recientes para un alta en tiempo real?
El BORME y el BODACC se actualizan a diario desde las fuentes oficiales. Companies House es descarga mensual más incrementos diarios. GET /coverage devuelve la fecha latest_filing de cada país.