API de empresas españolas: CIF/NIF, Registro Mercantil y BORME

Filings.es es la API REST de los datos oficiales del Registro Mercantil: valida un número de IVA intracomunitario (VIES), un CIF o un NIF, busca empresas por nombre o CIF, consulta administradores, propiedad, concursos y todo el historial del BORME de más de 3 millones de empresas españolas, y prospecta las nuevas empresas constituidas por provincia y código de actividad (CNAE).

Especificación OpenAPI 3.1: /openapi.json - para abrir en Postman, Insomnia o un generador de clientes.

Mi clave

La clave DEMO pública solo sirve para los ejemplos de esta página. Regístrate para consultar cualquier empresa (100 llamadas gratis).

Autenticación

Envía tu clave en la cabecera X-Api-Key (recomendado) o como parámetro ?apikey= (útil en el navegador). Genera y renueva tu clave desde tu cuenta.

Autorización por cabecera

Incluye tu clave en la cabecera de la petición: X-Api-Key: demo

Copiar

Autorización por URL

Para autorizar tus peticiones, añade ?apikey=demo al final de cada petición.

Copiar

Nota: usa &apikey= si el endpoint ya tiene otros parámetros en la query.

Búsqueda

Buscar empresas

Búsqueda por denominación, NIF/CIF o hoja registral.

¡Haz clic para probar el endpoint!Endpointhttps://api.filings.es/api/public/v1/es/search?query=iberdrola&limit=5 Copiar URL

Parámetros

(*) Obligatorio

ParámetroTipoEjemploDescripción
query*stringiberdrolaTérmino (mín. 2 caracteres).
limitinteger5Resultados por página (def. 20, máx. 100).
pageinteger2Página, desde 1 (máx. 20). La respuesta trae has_more y next: la URL lista de la página siguiente.
Respuesta200Abrir JSON ↗ Copiar respuesta
1{
2 "query": "iberdrola",
3 "page": 1,
4 "per_page": 5,
5 "count": 5,
6 "total": 54,
7 "total_pages": 11,
8 "total_is_capped": false,
9 "has_more": true,
10 "next": "https://api.filings.es/api/public/v1/es/search?query=iberdrola&limit=5&page=2",
11 "results": [
12 {
13 "registry_id": "BI167",
14 "name": "IBERDROLA SOCIEDAD ANONIMA",
15 "province_code": "48",
16 "first_seen": "2009-02-18",
17 "last_seen": "2026-08-13",
18 "announcement_count": "819",

Autocompletar

Sugerencias en tiempo real (empresas + administradores).

¡Haz clic para probar el endpoint!Endpointhttps://api.filings.es/api/public/v1/es/autocomplete?query=iberdro&limit=5 Copiar URL

Parámetros

(*) Obligatorio

ParámetroTipoEjemploDescripción
query*stringiberdroPrefijo (mín. 2 caracteres).
limitinteger5Sugerencias (def. 15, máx. 100). Sin paginación: afina escribiendo.
Respuesta200Abrir JSON ↗ Copiar respuesta
1{
2 "query": "iberdro",
3 "limit": 5,
4 "count": 5,
5 "matches": [
6 {
7 "tax_id": "B48421556",
8 "registry_id": "BI167",
9 "name": "IBERDROLA SOCIEDAD ANONIMA",
10 "province_code": "48",
11 "province": "Bizkaia",
12 "announcement_count": "819"
13 },
14 {
15 "tax_id": "A95075586",
16 "registry_id": "BI27059",
17 "name": "IBERDROLA GENERACION SOCIEDAD ANONIMA",
18 "province_code": "48",

Empresas

Ficha de empresa

Todos los datos de una empresa por su NIF, CIF o número de hoja registral: identidad, forma jurídica, capital, domicilio, CNAE, estado, administradores, propiedad y concursos.

¡Haz clic para probar el endpoint!Endpointhttps://api.filings.es/api/public/v1/es/company/B54226691 Copiar URL

Parámetros

(*) Obligatorio

ParámetroTipoEjemploDescripción
id*stringB54226691NIF/CIF o hoja registral. Lo obtienes con «Buscar empresas» o «Autocompletar» (p. ej. B54226691 o A105993).
Respuesta200Abrir JSON ↗ Copiar respuesta
1{
2 "registry_id": "A105993",
3 "name": "SOLER BULILLA SL",
4 "province_code": "03",
5 "first_seen": "2013-01-23",
6 "last_seen": "2022-02-28",
7 "announcement_count": "17",
8 "act_types": [
9 "Cambio de denominación social",
10 "Ceses/Dimisiones",
11 "Declaración de unipersonalidad",
12 "Nombramientos",
13 "Revocaciones"
14 ],
15 "province": "Alicante",
16 "tax_id": "B54226691",
17 "irus": "1000160268555",
18 "euid": "ES03026.000338341",

Administradores de la empresa

Administradores y apoderados (actuales e históricos) reconstruidos de los nombramientos y ceses del BORME.

¡Haz clic para probar el endpoint!Endpointhttps://api.filings.es/api/public/v1/es/company/B54226691/directors Copiar URL

Parámetros

(*) Obligatorio

ParámetroTipoEjemploDescripción
id*stringB54226691NIF, CIF o hoja registral.
Respuesta200Abrir JSON ↗ Copiar respuesta
1{
2 "tax_id": "B54226691",
3 "registry_id": "A105993",
4 "name": "SOLER BULILLA SL",
5 "directors": [
6 {
7 "name": "MARTINEZ MIGUELEZ MIGUEL FAUSTINO",
8 "role": "Sole director",
9 "last_event": "9999-12-31",
10 "status": "active",
11 "roles": [
12 "Administrador Único"
13 ],
14 "type": "administrador",
15 "since": "2015-01-23"
16 },
17 {
18 "name": "CRESPO VALTUILLE PEDRO",

Propiedad

Socio único, cap-table y titular real cuando están disponibles en el BORME.

¡Haz clic para probar el endpoint!Endpointhttps://api.filings.es/api/public/v1/es/company/B54226691/owners Copiar URL

Parámetros

(*) Obligatorio

ParámetroTipoEjemploDescripción
id*stringB54226691NIF, CIF o hoja registral.
Respuesta200Abrir JSON ↗ Copiar respuesta
1{
2 "tax_id": "B54226691",
3 "registry_id": "A105993",
4 "name": "SOLER BULILLA SL",
5 "sole_shareholder": "CRISTALERIA SOLER-HERMANOS SA",
6 "cap_table": [
7 {
8 "holder": "CRISTALERIA SOLER-HERMANOS SA",
9 "percent": 100,
10 "is_entity": false,
11 "since": "2013-01-23",
12 "resolution": null
13 }
14 ],
15 "beneficial_owner": {
16 "name": "CRISTALERIA SOLER-HERMANOS SA",
17 "percent": 100,
18 "is_entity": false,

Grafo de vinculaciones

Nodos y aristas que unen la empresa con sus administradores y las demás sociedades que dirigen.

¡Haz clic para probar el endpoint!Endpointhttps://api.filings.es/api/public/v1/es/company/B54226691/network Copiar URL

Parámetros

(*) Obligatorio

ParámetroTipoEjemploDescripción
id*stringB54226691NIF, CIF o hoja registral.
statusstringformerEje temporal: active (cargos actuales, por defecto), former (solo antiguos), all (ver todos).
depthinteger31 = solo consejo · 2 = + red de los miembros (por defecto) · 3 = + sus consejos · 4 = + consejos de las filiales.
kindstringassociesdirigeants (por defecto), associes o beneficiaires.
Respuesta200Abrir JSON ↗ Copiar respuesta
1{
2 "central": {
3 "kind": "siren",
4 "id": "co:A105993",
5 "displayName": "SOLER BULILLA SL",
6 "inactive": false
7 },
8 "nodes": [
9 {
10 "id": "co:A105993",
11 "kind": "siren",
12 "displayName": "SOLER BULILLA SL",
13 "siren": "A105993",
14 "sources": [
15 "borme"
16 ]
17 },
18 {

Concursos de la empresa

Procedimientos concursales asociados a la empresa.

¡Haz clic para probar el endpoint!Endpointhttps://api.filings.es/api/public/v1/es/company/B54226691/insolvency Copiar URL

Parámetros

(*) Obligatorio

ParámetroTipoEjemploDescripción
id*stringB54226691NIF, CIF o hoja registral.
Respuesta200Abrir JSON ↗ Copiar respuesta
1{
2 "tax_id": "B54226691",
3 "registry_id": "A105993",
4 "name": "SOLER BULILLA SL",
5 "insolvency": [
6 {
7 "id": "BOE-B-2014-33478",
8 "publication_date": "2014-09-27",
9 "city": "ALICANTE",
10 "tax_id": "B54226691",
11 "name": "Que en el procedimiento concursal número 930/12, referente al deudor Bilyana - Glass, S.L",
12 "type": "declaration",
13 "class": null,
14 "procedure_number": "09/2014",
15 "court": null,
16 "insolvency_administrator": null,
17 "order_date": "2014-09-08",
18 "contenido_edicto": null,

Historial BORME

Cronología de anuncios oficiales de la empresa.

¡Haz clic para probar el endpoint!Endpointhttps://api.filings.es/api/public/v1/es/company/B54226691/announcements Copiar URL

Parámetros

(*) Obligatorio

ParámetroTipoEjemploDescripción
id*stringB54226691NIF, CIF o hoja registral.
Respuesta200Abrir JSON ↗ Copiar respuesta
1{
2 "tax_id": "B54226691",
3 "registry_id": "A105993",
4 "name": "SOLER BULILLA SL",
5 "announcement_count": "17",
6 "timeline": [
7 {
8 "id": "6831845",
9 "publication_date": "2022-02-28",
10 "name": "SOLER BULILLA SL",
11 "act_types": [
12 "Revocaciones"
13 ],
14 "parsed_fields": {
15 "revocaciones": [
16 {
17 "name": "GONZALEZ JATO MIGUEL ANGEL",
18 "role": "Attorney-in-fact"

Administradores

Buscar administradores

Búsqueda de personas por nombre.

¡Haz clic para probar el endpoint!Endpointhttps://api.filings.es/api/public/v1/es/directors/search?query=garcia+lopez Copiar URL

Parámetros

(*) Obligatorio

ParámetroTipoEjemploDescripción
query*stringgarcia lopezNombre o apellidos.
Respuesta200Abrir JSON ↗ Copiar respuesta
1{
2 "query": "garcia lopez",
3 "results": [
4 {
5 "registry_id": "M626050",
6 "name": "CLEANING CAPITAL SL",
7 "role": "Liquidator",
8 "tax_id": "B87588158"
9 },
10 {
11 "registry_id": "A202963",
12 "name": "ANTOBERTO SL",
13 "role": "Adm. Solid.",
14 "tax_id": "B26618413"
15 },
16 {
17 "registry_id": "SE87255",
18 "name": "INIXIA STRATEGY SOCIEDAD LIMITADA",

Ficha de persona

Todos los mandatos (actuales e históricos) de una persona.

¡Haz clic para probar el endpoint!Endpointhttps://api.filings.es/api/public/v1/es/director/GARCIA%20GARCIA%20JOSE Copiar URL

Parámetros

(*) Obligatorio

ParámetroTipoEjemploDescripción
name*stringGARCIA GARCIA JOSENombre completo (como en el BORME).
Respuesta200Abrir JSON ↗ Copiar respuesta
1{
2 "person": {
3 "name": "GARCIA GARCIA JOSE",
4 "mandateCount": 344,
5 "currentCount": 101,
6 "formerCount": 243
7 },
8 "mandates": [
9 {
10 "registry_id": "B405986",
11 "name": "DAVERPUNT SA",
12 "tax_id": "A65453755",
13 "id": "B405986",
14 "province_code": "08",
15 "province": "Barcelona",
16 "role": "REP.ADM.CONC",
17 "start_date": "2026-03-05",
18 "end_date": null,

Cumplimiento (KYB)

Validar un número de IVA (VIES)

Comprueba el número de IVA intracomunitario en VIES, el servicio oficial de la Comisión Europea, y lo cruza con nuestra ficha registral. Es la verificación exigida antes de facturar sin IVA a un cliente europeo. Respuesta: valid, invalid o unavailable, una caída de la administración nunca se presenta como invalidez.

¡Haz clic para probar el endpoint!Endpointhttps://api.filings.es/api/public/v1/es/vat/A15075062 Copiar URL

Parámetros

(*) Obligatorio

ParámetroTipoEjemploDescripción
nif*stringA15075062NIF/CIF español, con o sin el prefijo ES.
Respuesta200Abrir JSON ↗ Copiar respuesta
1{
2 "tax_id": "A15075062",
3 "vat_number": "ESA15075062",
4 "country": "ES",
5 "status": "valid",
6 "checked_at": "2026-08-15 08:39:26.105+00",
7 "cached": true,
8 "name": null,
9 "address": null,
10 "company": {
11 "tax_id": "A15075062",
12 "registry_id": "C3342",
13 "name": "INDUSTRIA DE DISEÑO TEXTIL, S.A.(R.M. A CORUÑA)",
14 "province": null,
15 "active": true
16 }
17}

Prospección

Nuevas empresas constituidas

Las sociedades constituidas recientemente, filtrables por provincia, sector (código CNAE) y capital. Devuelve domicilio y teléfono cuando constan. Por defecto: últimos 30 días.

¡Haz clic para probar el endpoint!Endpointhttps://api.filings.es/api/public/v1/es/new-companies?provincia=29&since=2026-07-01&limit=5 Copiar URL

Parámetros

ParámetroTipoEjemploDescripción
sincestring2026-07-01Constituidas desde esta fecha (AAAA-MM-DD). Def.: hace 30 días.
provinciastring29Código INE de provincia (29 = Málaga). Lista en /provinces.
cnaestring6920Código de actividad, por PREFIJO: «64» abarca toda la finanza, «6920» las asesorías. Lista en /cnae.
min_capitalstring3000Capital social mínimo, en euros.
limitinteger5Resultados por página (def. 50, máx. 100).
pageinteger2Página, desde 1 (máx. 20).
Respuesta200Abrir JSON ↗ Copiar respuesta
1{
2 "page": 1,
3 "per_page": 5,
4 "count": 5,
5 "has_more": true,
6 "filters": {
7 "since": "2026-07-01",
8 "until": null,
9 "province": "29",
10 "activity": null
11 },
12 "results": [
13 {
14 "tax_id": "B93778272",
15 "registry_id": "MA200192",
16 "name": "STEAM OUTREACH COMPANY SL",
17 "legal_form": "Sociedad Limitada (SL)",
18 "activity_code": "6421",

Directorio por sector

Todas las sociedades de un sector y una provincia, no solo las nuevas. «Soy asesor, dame las gestorías de Málaga.» Se exige al menos un criterio: provincia o sector.

¡Haz clic para probar el endpoint!Endpointhttps://api.filings.es/api/public/v1/es/directory?cnae=6920&provincia=29&limit=5 Copiar URL

Parámetros

ParámetroTipoEjemploDescripción
cnaestring6920Código de actividad, por prefijo. Obligatorio si falta provincia.
provinciastring29Código INE de provincia. Obligatorio si falta cnae.
active_onlystringfalseExcluye las sociedades extinguidas (def. true).
min_capitalstring60000Capital social mínimo, en euros.
Respuesta200Abrir JSON ↗ Copiar respuesta
1{
2 "page": 1,
3 "per_page": 5,
4 "count": 5,
5 "has_more": true,
6 "filters": {
7 "province": "29",
8 "activity": "6920",
9 "active_only": true
10 },
11 "results": [
12 {
13 "tax_id": "B82190851",
14 "registry_id": "MA112044",
15 "name": "PRICEWATERHOUSECOOPERS SERVICE DELIVERY CENTER (MALAGA) SL",
16 "legal_form": "Sociedad Limitada (SL)",
17 "activity_code": "6920",
18 "activity_label": "Actividades de contabilidad, teneduría de libros, auditoría y asesoría fiscal",

Códigos de actividad (CNAE)

La nomenclatura completa, con el NÚMERO de sociedades por código, para valorar de inmediato si un objetivo es realista. Busca por descripción («agricultura», «software») para dar con el código sin conocerlo.

¡Haz clic para probar el endpoint!Endpointhttps://api.filings.es/api/public/v1/es/cnae?query=informatica Copiar URL

Parámetros

ParámetroTipoEjemploDescripción
querystringinformaticaFiltra por código o descripción.
Respuesta200Abrir JSON ↗ Copiar respuesta
1{
2 "count": 8,
3 "query": "informatica",
4 "results": [
5 {
6 "code": "6209",
7 "label": "Otros servicios relacionados con las tecnologías de la información y la informática",
8 "companies": 11442
9 },
10 {
11 "code": "6201",
12 "label": "Actividades de programación informática",
13 "companies": 9529
14 },
15 {
16 "code": "6202",
17 "label": "Actividades de consultoría informática",
18 "companies": 7178

Provincias

Los códigos INE de provincia con su nombre y el número de sociedades. Es la clave del parámetro provincia de los demás endpoints.

¡Haz clic para probar el endpoint!Endpointhttps://api.filings.es/api/public/v1/es/provinces Copiar URL
Respuesta200Abrir JSON ↗ Copiar respuesta
1{
2 "count": 52,
3 "results": [
4 {
5 "code": "01",
6 "name": "AR",
7 "companies": 16374
8 },
9 {
10 "code": "02",
11 "name": "Albacete",
12 "companies": 24671
13 },
14 {
15 "code": "03",
16 "name": "A Coruña",
17 "companies": 165468
18 },

Justicia (concursal)

Buscar concursos

Edictos de insolvencia por denominación o CIF (BOE Sección IV + RPC).

¡Haz clic para probar el endpoint!Endpointhttps://api.filings.es/api/public/v1/es/insolvency/search?query=construcciones&limit=5 Copiar URL

Parámetros

(*) Obligatorio

ParámetroTipoEjemploDescripción
query*stringconstruccionesDenominación o CIF.
limitinteger5Resultados (def. 50, máx. 100).
Respuesta200Abrir JSON ↗ Copiar respuesta
1{
2 "query": "construcciones",
3 "filters": {
4 "type": "",
5 "since": "",
6 "until": "",
7 "subject": "",
8 "limit": 5
9 },
10 "types": {
11 "declaracion": "Declaración de concurso",
12 "liquidacion": "Apertura de liquidación",
13 "convenio": "Convenio de acreedores",
14 "conclusion": "Conclusión del concurso",
15 "otro": "Otro acto concursal"
16 },
17 "results": [
18 {

Edicto íntegro

Texto completo de un edicto concursal. El identificador NO se inventa: lo devuelve «Buscar concursos» (campo boe_id) · RPC-N viene del Registro Público Concursal, BOE-B-AAAA-N de los edictos del BOE.

¡Haz clic para probar el endpoint!Endpointhttps://api.filings.es/api/public/v1/es/insolvency/RPC-455662 Copiar URL

Parámetros

(*) Obligatorio

ParámetroTipoEjemploDescripción
boe_id*stringRPC-455662boe_id devuelto por «Buscar concursos» (p. ej. RPC-455662).
Respuesta200Abrir JSON ↗ Copiar respuesta
1{
2 "id": "RPC-455662",
3 "publication_date": "2025-01-24",
4 "name": "CONSTRUCCIONES MURIAS SA",
5 "tax_id": "A20038279",
6 "type": "otro",
7 "court": "Mercantil de San Sebastián - 1",
8 "raw_text": "Informe de la Administración concursal",
9 "type_label": "Otro acto concursal"
10}

Screener

Filtrar eventos BORME

Filtra los anuncios del BORME por tipo de acto, provincia y fechas.

¡Haz clic para probar el endpoint!Endpointhttps://api.filings.es/api/public/v1/es/screener?provincia=28&acto=Constituci%C3%B3n&limit=5 Copiar URL

Parámetros

ParámetroTipoEjemploDescripción
actostringConstituciónTipo de acto.
provinciastring28Código INE (p. ej. 28).
sincestring2026-01-01Desde (YYYY-MM-DD).
limitinteger5Resultados (def. 50, máx. 100).
Respuesta200Abrir JSON ↗ Copiar respuesta
1{
2 "filters": {
3 "acto": "Constitución",
4 "province": "28",
5 "since": "",
6 "until": "",
7 "limit": 5
8 },
9 "results": [
10 {
11 "id": "9742490",
12 "publication_date": "2026-08-14",
13 "name": "PERSEPOLIS ITG SL",
14 "registry_id": "M894616",
15 "province_code": "28",
16 "act_types": [
17 "Constitución",
18 "Declaración de unipersonalidad",

Planes y precios

Pagas por llamadas/mes (1 llamada = 1 unidad). Todos los planes incluyen todos los endpoints, sin límite de peticiones por minuto.

Hasta −25 % al año

Gratis

0 €

Al registrarte, sin tarjeta.

100 llamadas / mes

  • Todos los endpoints REST
  • Ficha de empresa y administradores
  • Búsqueda y autocompletar
  • Clave al instante

Elegir plan →

Starter

14 €/mes

facturado anualmente

2 000 llamadas / mes

…todo lo de Gratis, más:

  • Propiedad y titular real
  • Historial BORME completo
  • Respuestas en español o inglés
  • Soporte por email

Elegir plan →

Popular

Pro

22 €/mes

facturado anualmente

10 000 llamadas / mes

…todo lo de Starter, más:

  • Concursos: BOE Sección IV + RPC
  • Screener de eventos BORME
  • Fichas de administradores
  • Soporte prioritario

Elegir plan →

Business

59 €/mes

facturado anualmente

30 000 llamadas / mes

…todo lo de Pro, más:

  • Volumen de producción
  • Datos registrales completos
  • Factura con IVA e informe de uso
  • Acceso anticipado a nuevos endpoints

Elegir plan →

¿Más volumen? A partir de 100 000 llamadas/mes, volcados completos o SLA a medida: te preparamos un plan.

Contactar

Códigos de respuesta

200OKPetición correcta.
401UnauthorizedFalta la clave (cabecera X-Api-Key o ?apikey=), o es inválida.
402Payment RequiredLímite mensual de llamadas agotado (100 en el plan gratuito). Suscríbete o sube de plan.
404Not FoundRecurso no encontrado.

¿Listo para empezar?

Crear una cuenta gratis