BORME API

Notas de ingeniería · KYB

Tu consulta KYB española dice «existe». Así se responde «quién la dirige»

2026-07-16 · 4 min · con código que funciona

Toda integración KYB española empieza igual: una consulta por CIF/NIF que devuelve la denominación social, un domicilio y un código CNAE. Necesario — y muy lejos de bastar para decidir un alta. El proveedor que usaremos de ejemplo, Verifik, documenta exactamente estos campos para su endpoint /v2/es/company.

Lo que falta es todo aquello que cambia: quiénes son los administradores actuales, qué le ha pasado a la empresa a lo largo de su vida y si está ahora mismo en un procedimiento concursal. Todo eso se publica en el boletín oficial del registro mercantil español (BORME) — y nosotros lo hemos procesado íntegramente desde 2009 en una API tipada.

El patrón: dos llamadas después de tu consulta principal

primary = verifik(cif)                       # nombre, domicilio, CNAE
slug    = borme.events(name_contains=primary.businessName)[0].company_slug
card    = borme.companies(slug)              # ← la parte interesante

Script completo y funcional (60 líneas, solo requests): gist.github.com/george-kozlitin/enrich_spanish_kyb.py

Ejecutado sobre el propio ejemplo de la documentación de Verifik

La documentación de Verifik ilustra el endpoint con SERESCO SA (CIF 33011826, una empresa asturiana de software). Su respuesta: nombre, domicilio, CNAE 6209, teléfono. Pasando ese nombre por el enriquecimiento:

PRIMARY  : SERESCO SA. | SOCIEDAD ANONIMA | CNAE 6209
STATUS   : active
OFFICERS : 11 cargos vigentes (consejo, consejero delegado, auditores — con nombres)
HISTORY  : 53 actos registrales desde 2009
  2026-XX-XX  APPOINTMENTS+TERMINATIONS  → boe.es/borme/.../BORME-A-....pdf

La misma consulta, un orden de magnitud más de datos relevantes para decidir — y cada acto con su enlace al PDF oficial del BOE para el expediente de auditoría.

El BORME no publica el CIF/NIF, de modo que esto es una capa de *enriquecimiento*, no un sustituto de la verificación primaria. El enlace se hace por denominación social más provincia (más del 99 % de resolución en la práctica) o de forma exacta por la hoja registral si tu fuente principal la devuelve. Detalles en bormeapi.com/es/partners.

La parte que tus usuarios notarán de verdad: la monitorización

El alta es una fotografía; el riesgo es un flujo. La misma API expone webhooks firmados con HMAC por empresa vigilada: salidas de administradores, operaciones de capital y solicitudes de concurso llegan a tu sistema la misma mañana en que los publica el boletín. Esa es la capa que los proveedores registrales tradicionales no venden.

Documentación de la API Notas de integración para plataformas KYB

build 2026.08.19·2ba6b50