El Registro Mercantil publica los actos que inscribe (constituciones, nombramientos, cambios de domicilio, extinciones y más) en el BORME, que edita la Agencia Estatal BOE. El BOE ofrece una API de datos abiertos para leerlo. Este tutorial explica cómo funciona, qué devuelve y qué te queda por construir para convertir un boletín diario en fichas de empresa útiles.
Todo lo que sigue procede de la documentación del BOE, «API para el acceso a los sumarios del BORME», consultada el 9 de octubre de 2026.
Lo que vas a aprender
- Qué hace la API del BORME, y qué no
- Cómo llamarla, con peticiones que funcionan
- Cómo es la respuesta
- Cómo pasar del sumario diario a los actos de cada sociedad
- Las partes difíciles: análisis, enlace y historial
Qué te da la API
La API sirve el sumario del BORME de cada día: la lista de publicaciones por sección. En la sección A (actos inscritos), un elemento por registro provincial, con enlaces al texto de esa provincia para ese día.
No ofrece una búsqueda de sociedades, ni una ficha de empresa, ni una consulta por NIF. Ofrece el índice oficial de cada día, desde el que se llega a los textos publicados. El resto lo construyes tú.
Cómo llamarla
Según la documentación, es una API REST sobre HTTPS. Las peticiones usan solo el método GET; cualquier otro (POST, PUT…) devuelve un error 403. El formato se elige con la cabecera Accept: XML o JSON.
Hay una sola llamada: /datosabiertos/api/borme/sumario/{fecha}, con la fecha obligatoria en formato AAAAMMDD. El ejemplo de la documentación:
curl -L -X GET -H "Accept: application/xml" \
"https://boe.es/datosabiertos/api/borme/sumario/20240529"Y en JSON:
curl -L -X GET -H "Accept: application/json" \
"https://boe.es/datosabiertos/api/borme/sumario/20240529"Los códigos de retorno son los habituales: 200 si todo va bien, 400 si el identificador o los parámetros no son válidos, 404 si la información solicitada no existe (por ejemplo, un día sin boletín) y 5xx si falla el servidor. El BORME se publica en días hábiles: un 404 en fin de semana o festivo significa «no hay boletín», no un error.
Cómo es la respuesta
Según la documentación, la respuesta tiene un nodo raíz con dos hijos:
- status, con un
codey untextbreve (200 y «ok» si todo va bien); - data, con el
sumario: sus metadatos (la publicación,BORME, y la fecha) y undiariocon su número.
Dentro, cada sección tiene un código y un nombre. La sección A es «SECCIÓN PRIMERA. Empresarios. Actos inscritos». Cada item tiene:
- un identificador, como
BORME-A-2024-102-03: sección, año, número del boletín y código de la provincia; - un título, la provincia, como
ALICANTE/ALACANT; - enlaces a la publicación de esa provincia en varios formatos, entre ellos un texto HTML (
url_html) y una versión XML (url_xml), con las páginas.
El sumario es un mapa: para una fecha, qué provincias publicaron actos y dónde leerlos.
Del sumario a los actos de cada sociedad
- Descarga el sumario de la fecha. Ignora los 404.
- Toma los elementos de la sección A, uno por provincia.
- Descarga el texto de cada provincia con los enlaces del elemento.
- Divide el texto en anuncios. Cada anuncio se refiere a una sociedad: un número, la denominación, uno o varios actos con su etiqueta (Constitución, Nombramientos, Ceses/Dimisiones, Cambio de domicilio social, Extinción…) y los datos registrales con la hoja y la fecha de inscripción.
- Analiza cada acto: su tipo y su detalle.
- Enlaza el anuncio con una sociedad por la provincia y la hoja registral, no por el nombre: los nombres cambian, las hojas no.
- Guarda el acto con su referencia y sus fechas, para que cada dato se pueda rastrear hasta el BOE.
Repítelo cada día hábil, conserva el historial, y tendrás una cronología por sociedad. Para entender cada acto, lee cómo leer el BORME.
Las partes difíciles
El análisis es casi todo el trabajo. Los textos están escritos para personas. Hay convenciones, pero las etiquetas varían, varios actos comparten anuncio y los actos sobre cargos mezclan funciones y nombres en texto corrido.
El enlace necesita la hoja. El BORME no publica el NIF. La clave estable es la provincia más la hoja registral. Si tus usuarios solo tienen un NIF, no podrás enlazarlo con el BORME solo.
El historial empieza cuando empiezas. Cada día es una llamada más una descarga por provincia. Reunir años de historial exige una carga larga, y mantenerla cada día después.
Datos personales. Los actos sobre cargos contienen nombres de personas. Decide qué guardas, para qué y cuánto tiempo, conforme a la normativa de protección de datos.
Condiciones de reutilización. La documentación indica que reutilizar la información implica aceptar las condiciones del BOE. Léelas y cita al BOE como fuente.
¿Merece la pena construirlo?
Para una provincia, un caso de uso o un proyecto de investigación, la API es el punto de partida correcto: oficial, gratuita y sencilla. Construir y mantener un historial diario, analizado y enlazado de todas las provincias es otro proyecto, con un mantenimiento que no termina. Para el contexto, lee el BORME explicado y cómo comprobar una empresa española antes de firmar.
Fuentio lee el BORME cada día hábil y servirá los actos analizados de cada sociedad española, enlazados por provincia y hoja, con la referencia del BOE y las fechas de cada acto, desde el 6 de octubre de 2025. La API aún no está abierta: apúntate abajo para saber el día que abra.
Consulta lo que cubrimos en Francia y España.
Límites. El funcionamiento de la API procede de la documentación del BOE (versión 2.0 de 28 de mayo de 2026), consultada el 9 de octubre de 2026; compruébala antes de construir, porque puede cambiar. Este tutorial describe un servicio público del BOE; no está afiliado a él.
Preguntas frecuentes
¿El BOE tiene una API para el BORME?
Sí. La API de datos abiertos del BOE sirve el sumario diario del BORME en XML o JSON, en /datosabiertos/api/borme/sumario/{fecha}.
¿Puedo buscar una sociedad por nombre o NIF con la API?
No. Devuelve el sumario de cada día. La búsqueda y el enlace los construyes tú, y el BORME no publica el NIF.
¿Por qué recibo un 404?
Ese día no hay BORME, normalmente un fin de semana o un festivo.
¿La API del BORME es gratuita?
Es un servicio de datos abiertos del BOE; reutilizar la información implica aceptar sus condiciones.