¿Cómo consulto una empresa por su NIF y los actos del BORME que le afectan?

Dos llamadas: GET /companies/search?country=ES&company_number=<NIF> devuelve la ficha de la sociedad y GET /company-events/search?country=ES&company_number=<NIF> sus actos del BORME, los más recientes primero.

Llamada 1: la ficha de la empresa

curl 'https://api.prometiam.com/functions/v1/risk-api/companies/search?country=ES&company_number=A15075062' \
  -H 'Authorization: Bearer rk_live_demo_publichn'

La clave demo sirve para esta llamada. Respuesta del 10 de noviembre de 2026, recortada:

{
  "data": [
    {
      "id": 1741526,
      "match_type": "exact",
      "country": "ES",
      "company_number": "A15075062",
      "company_name": "INDUSTRIA DE DISEÑO TEXTIL, S.A",
      "identifiers": [ { "type": "nif", "value": "A15075062" }, { "type": "vat", "value": "ESA15075062" } ],
      "vat_number": "ESA15075062",
      "vat_number_source": "rule",
      "lei": "549300TTCXZOGZM2EY83",
      "legal_form": "SA",
      "status": "active",
      "founding_date": "1985-06-12",
      "address": "AV. DIPUTACIÓN SIN EDIFICIO INDITEX, 15142, ARTEIXO, LA CORUÑA",
      "register": "BORME (Registro Mercantil)",
      ...
    }
  ],
  "pagination": { "count": 1, "has_more": false, "next_cursor": null },
  "meta": { "search_mode": "company_number_exact", "country": "ES", ... }
}

Datos clave: España

• Registro: BORME (Registro Mercantil)
• Identificadores: NIF / CIF
• Fichas de empresa: Sí
• Administradores: Sí
• Avisos de insolvencia: Sí
• Eventos societarios: Avisos del boletín
• Monitorización: Sí
• Cuentas anuales: Empresas cotizadas
• Número de IVA: Construido desde el identificador
• Clase NACE: Sí
• Actualización: A diario
• Las cuentas anuales están en el plan Scale y superiores; los demás planes y la prueba gratuita tienen 10 llamadas al mes.
• Precio: Desde 9,99 EUR al mes (plan Starter)

Llamada 2: sus actos del BORME

La clave demo no incluye los eventos societarios. Hace falta una clave propia con el alcance company_events (desde Starter; una clave de prueba tiene 25 llamadas):

curl 'https://api.prometiam.com/functions/v1/risk-api/company-events/search?country=ES&company_number=A15075062&limit=3' \
  -H 'Authorization: Bearer rk_live_...'

Respuesta obtenida el 10 de noviembre de 2026 con una clave real. El texto de los actos nombra a las personas nombradas o cesadas, así que aquí se corta:

{
  "data": [
    {
      "id": 19771872,
      "company_id": 1741526,
      "company_name": "INDUSTRIA DE DISEÑO TEXTIL, S.A",
      "company_number": "A15075062",
      "country": "ES",
      "source": "BORME (Spain)",
      "event_type": "director_change",
      "act_type": "NOMBRAMIENTOS",
      "signal": "leadership_change",
      "event_date": "2026-10-22",
      "event_detail": "INDUSTRIA DE DISEÑO TEXTIL, S.A.(R.M. A CORUÑA).\nNombramientos. Apoderado: ...",
      "notice_url": "https://www.boe.es/borme/dias/2026/10/22/pdfs/BORME-A-2026-204-15.pdf",
      ...
    },
    { "id": 19717006, "event_type": "director_change", "act_type": "NOMBRAMIENTOS", "event_date": "2026-10-06", ... },
    { "id": 19717005, "event_type": "director_change", "act_type": "CESES_DIMISIONES", "event_date": "2026-10-06", ... }
  ],
  "pagination": { "count": 3, "has_more": true, "next_cursor": "2026-10-06_19717005" },
  "meta": { "search_mode": "company_number_exact", ... }
}

Con include=notice cada evento trae la publicación de la que sale: {"id": 206701, "source": "BORME", "published_date": "2026-10-22", "reference": "BORME-A-2026-204-15", "type": "A", "region": "A CORUÑA", "url": "..."}.

Cómo leer la respuesta

Campo	Qué significa
company_number, vat_number	El NIF y el número de IVA. Con vat_number_source rule el número se construye a partir del NIF; compruébalo con GET /vat/{número}.
event_type, act_type	El tipo normalizado (director_change) y el acto del BORME (NOMBRAMIENTOS, CESES_DIMISIONES).
event_date	La fecha de publicación del acto en el BORME.
event_detail	El acto tal como lo imprime el BORME, sin reescribir. Puede nombrar a personas físicas (administradores, apoderados); en el ejemplo de esta página se han omitido.
notice_url	La página del BORME en el Boletín Oficial del Estado.
pagination.next_cursor	Devuélvelo como cursor mientras has_more sea true.

Cuánto cuesta

La búsqueda de empresa cuesta 1 crédito y la de eventos 2, 3 por el par. Los errores no cuestan nada. Starter (9,99 €) incluye 1.000 créditos al mes, Professional (29,99 €) 10.000 y Scale (99,99 €) 50.000.

Límites

• El NIF debe ser el de una sociedad: letra de entidad, siete dígitos y carácter de control. Un DNI o un NIE se rechaza.
• Si un NIF no da resultado con la letra A o B, la búsqueda puede devolver la sociedad que tiene los mismos dígitos con la otra letra (match_type nif_other_letter, con un aviso en meta). Confirma la denominación; la llamada de eventos sigue siendo exacta.
• Los eventos salen del BORME, que publica los actos del Registro Mercantil; no son el registro. Para el texto jurídico, lee la página del BORME.
• Crédito: Based on data from the Agencia Estatal Boletín Oficial del Estado (BORME).

Qué puede fallar

• 400 validation_error: el NIF está mal formado, por ejemplo A1507506, con un carácter de menos, o limit no está entre 1 y 100.
• 403 upgrade_required: la clave no tiene el alcance company_events o ha agotado las llamadas de prueba.
• 429: límite por minuto o créditos agotados. La cabecera X-RateLimit-Reset indica cuándo se reinicia.

Páginas relacionadas

• Verificar el NIF de una empresa por API
• Qué es el BORME
• API del BORME
• API de datos de empresas españolas
• Buscar una empresa por su CIF o NIF
• Receta en inglés: empresa por NIF y eventos del BORME

Regístrate · Documentación de la API

La prueba dura 14 días e incluye 500 créditos. Se pide una tarjeta, pero no se cobra nada durante la prueba; después sigue el plan Starter (9,99 € al mes) salvo que la canceles.