Guía · España
API del BORME: consultar el Registro Mercantil en JSON
El BORME se publica como PDF. Una API lo convierte en empresas, cargos y actos consultables por NIF, nombre o fecha. Aquí tienes los endpoints, con peticiones y respuestas reales.
Qué problema resuelve
Cada día laborable el BOE publica el Boletín Oficial del Registro Mercantil: constituciones, nombramientos y ceses de administradores, ampliaciones y reducciones de capital, cambios de domicilio, fusiones, disoluciones y concursos. Está pensado para leerse, no para consultarse. Si necesitas saber si un NIF existe, quién administra la sociedad hoy o si se ha publicado algo sobre un cliente esta semana, hay que estructurar esos boletines. Eso es lo que hace una API del BORME. Si primero quieres entender qué publica el boletín y cómo se lee un NIF, empieza por ¿Qué es el BORME?
Los endpoints que vas a usar
| Endpoint | Para qué |
|---|---|
GET /companies/search | Resolver una empresa por nif= (exacto) o por name= (búsqueda normalizada, sin acentos). Con founded_after= lista las constituciones desde una fecha. |
GET /companies/{id} | Ficha completa: forma jurídica, domicilio, CNAE, capital, fecha de constitución, estado y cargos vigentes. |
GET /company-events/search | Actos publicados por tipo: director_change, capital_change, new_incorporation, name_change, address_change, dissolution, liquidation, merger, insolvency, power_of_attorney, securities_issue, object_change, bylaws_change and more (19 finer types since 9 Oct 2026). |
GET /search | Anuncios concursales y de riesgo de España, con el enlace al PDF del BOE de cada acto. |
POST /monitor | Alta de una empresa en vigilancia: aviso cuando el BORME publique un acto que la afecte. |
Todas las respuestas comparten la misma forma: un bloque data, paginación por cursor y un bloque meta con el tiempo de consulta y el límite restante. La clave va en la cabecera Authorization: Bearer rk_live_….
Ejemplo: resolver un NIF
curl "https://api.prometiam.com/functions/v1/risk-api/companies/search?nif=A28015865&country=ES" \ -H "Authorization: Bearer $PROMETIAM_API_KEY"
{
"data": [
{
"id": 812044,
"match_score": 100,
"company_number": "A28015865",
"company_name": "TELEFONICA, S.A.",
"legal_form": "SA",
"region": "MADRID",
"address": "C/ Gran Via 28, 28013 Madrid",
"activity_code": "6110",
"activity_code_scheme": "CNAE",
"capital_eur": 4551929995.36,
"status": "active",
"country": "ES",
"first_seen_date": "1988-01-01",
"last_seen_date": "2026-03-28"
}
],
"pagination": { "count": 1, "has_more": false, "next_cursor": null }
}Con el id pides la ficha completa en GET /companies/812044: cargos vigentes con su fecha de nombramiento, objeto social, coordenadas registrales y, con include=insolvency,risk_flags, los anuncios concursales y los avisos de riesgo publicados sobre esa sociedad.
Ejemplo: anuncios publicados sobre una empresa
curl "https://api.prometiam.com/functions/v1/risk-api/search?vat=A46103834" \ -H "Authorization: Bearer $PROMETIAM_API_KEY"
{
"data": [
{
"id": 4819921,
"company_name": "MERCADONA, S.A.",
"vat_number": "A46103834",
"country": "ES",
"status": "active",
"event_type": "capital_change",
"city": "Valencia",
"filing_date": "2026-03-18",
"source": "BORME (Spain)",
"notice_url": "https://www.boe.es/borme/dias/2026/03/18/pdfs/BORME-A-2026-53-46.pdf"
}
],
"pagination": { "count": 1, "has_more": false, "next_cursor": null }
}Cada anuncio enlaza al PDF original del BOE, así que el dato es verificable en la fuente oficial. Filtra por event_type= y por rango de fechas con date_from= y date_to=.
Vigilar una cartera de clientes
Para no consultar cada día, das de alta las empresas en POST /monitor y recibes un aviso cuando se publique un acto sobre ellas: cese de un administrador, reducción de capital, disolución o concurso. La vigilancia está disponible para todos los países en producción excepto Francia y Chile, con México limitado a las entidades con LEI y Argentina sin alerta de disolución. Un ejemplo completo con Cloudflare Workers y avisos en Slack está en la guía de lista de vigilancia del BORME; el caso de uso de control de crédito, en monitorización de insolvencia de clientes.
Lo que no está en el BORME
- Cuentas anuales completas. Se depositan en el Registro Mercantil; el boletín publica el hecho del depósito, no las cifras.
- Titularidad real. El acceso general se restringió tras la sentencia del TJUE de noviembre de 2022. Prometiam no la sirve.
- Autónomos. El BORME recoge sociedades y otros sujetos inscribibles, no empresarios individuales sin inscripción.
Antes de gastar una llamada, valida el NIF en local: la letra de control se calcula. La guía verificar el NIF de una empresa por API incluye el código, y el validador de identificadores lo hace en el navegador.
Preguntas frecuentes
¿Existe una API oficial del BORME?
El BOE publica el BORME como PDF diario y ofrece un servicio de datos abiertos con los sumarios, pero no una API de empresas consultable por NIF. Las API del BORME son servicios que estructuran esos boletines en registros de empresa, cargos y actos.
¿Puedo buscar una empresa por NIF?
Sí. GET /companies/search?nif=A28015865&country=ES devuelve la empresa con su id interno; GET /companies/{id} devuelve la ficha completa con cargos vigentes.
¿Incluye los concursos de acreedores?
Los concursos de acreedores de España (declaración, apertura de la fase de liquidación y conclusión, enlazados a la empresa por NIF) se consultan en GET /insolvency/search, y los anuncios concursales y de riesgo también en GET /search, con enlace al PDF del BOE de cada acto. El índice /insolvency/search cubre dieciséis mercados, España entre ellos.
¿Cuánto cuesta?
Hay una prueba gratuita de 14 días con 500 créditos sin cobro hasta que termine la prueba y planes publicados desde 9,99 € al mes. No hace falta hablar con ventas.
¿Hay una API del Registro Mercantil?
Los actos inscritos en el Registro Mercantil se publican en el BORME, y el BOE ofrece sumarios en datos abiertos pero no una API de empresas por NIF. La API de Prometiam estructura esos boletines y permite consultar por NIF, nombre o fecha.
¿Hay una API del BORME gratuita?
El BORME es público y gratuito en boe.es, pero en PDF. Para consultarlo en JSON por NIF hay una prueba gratuita de 14 días con 500 créditos, con tarjeta y sin cobro durante la prueba, y después planes desde 9,99 € al mes.
¿Cómo consulto por API los datos abiertos del BORME y el BOE?
Resuelve la empresa con GET /companies/search?nif=...&country=ES y pide la ficha con GET /companies/{id}. Los actos publicados, con enlace al PDF del BOE, están en GET /company-events/search.
¿Puedo obtener las cuentas anuales de una empresa española por API?
No de forma general: el BORME no publica las cuentas, solo el hecho del depósito. Prometiam sirve los informes financieros anuales de las sociedades españolas cotizadas (ESEF), desde el plan Scale, y esos informes están disponibles gratuitamente en la web de la CNMV. Para el resto de sociedades no están disponibles.
Precio
Prueba gratuita de 14 días con 500 créditos sin cobro hasta que termine la prueba, y planes publicados desde 9,99 € al mes en la página de precios. La misma clave y el mismo esquema de respuesta sirven para todos los demás países que cubre la API. La referencia completa está en la documentación de la API.