BORME API
Spain · BORME Section A · observed since 2009

Resolve a company. Reconstruct what was published about it.

BORME API turns Spain’s official company-gazette notices into a maintained intelligence layer: resolve a company, reconstruct its published history, expose officers and brands, monitor changes, and keep the official-source provenance beside every result.

official notices in · typed, replayable evidence out
BORME-A-2026-123-28 · MADRID · 30/06/2026 · Acto 308560

VAZ METALES SL. Sociedad unipersonal. Cambio de identidad del socio único: CID SAEZ JESUS MIGUEL. Ceses/Dimisiones. Adm. Unico: VAZ CULEBRAS JOAQUIN. Nombramientos. Adm. Unico: CID SAEZ JESUS MIGUEL. Cambio de domicilio social. C/ SAN JOSE DE CALASANZ 1 (VILLANUEVA DEL PARDILLO). Datos registrales. S 8, H M 507991, I/A 2 (23.06.26).

{
  "company_name": "VAZ METALES SL.",
  "date": "2026-06-30", "province": "MADRID",
  "acts": [
    { "act_type": "SOLE_SHAREHOLDER_CHANGE",
      "payload": "CID SAEZ JESUS MIGUEL" },
    { "act_type": "TERMINATIONS", "roles": [{
      "role": "SOLE_DIRECTOR",
      "names": ["VAZ CULEBRAS JOAQUIN"] }] },
    { "act_type": "APPOINTMENTS", "roles": [{
      "role": "SOLE_DIRECTOR",
      "names": ["CID SAEZ JESUS MIGUEL"] }] },
    { "act_type": "ADDRESS_CHANGE" }
  ],
  "registral": { "hoja": "M 507991", "inscription": "2" }
}
hover the Spanish — see where it lands in the JSON
9,573,786published events · 2009 → today, replayable
51emitted act types, plus registral metadata
56normalized officer roles with names
3,291,829companies in the reconstructed published history
1,336,218OEPM rights · 424,343 OEPM company links · 182,846 linked companies

Production baseline as of 24 August 2026: 9,573,786 events, 3,291,829 companies, more than 520,000 NIF mappings and 1,252,115 risk signals. OEPM rights, company links and linked companies are separate counts.

From a published notice to a decision-ready company record

Start with the identity you have; keep the ambiguity when the evidence does not resolve it.

Resolve a company

Use one NIF or one registry sheet (hoja) at a time. NIF mappings expose source and confidence; hoja results preserve the published coordinate and return ambiguity explicitly.

GET /v1/companies/by-nif/A46103834 → snapshot: officers, status, insolvency

Reconstruct published history

Fold dated acts into a useful timeline or an as-of view, bounded by what the published BORME history showed by that date.

GET /v1/companies/{slug}/events?limit=100 → oldest-first published timeline

Monitor change

Watch companies and receive new published events or risk signals without repeatedly rebuilding the same ingestion pipeline.

POST /v1/watchlists {"company_slug":"acme-sl","webhook_url":"https://example.com/borme"} → signed delivery after new published events

Expose officers and brands

Move from a person or OEPM brand name to sourced candidates. An OEPM alias is not silently promoted to a tax-ID match.

GET /v1/brands?q=freixenet → holder, marks, trading names

Keep the evidence

Every event retains its official-source provenance: gazette issue, act number and source link travel with the normalized record.

GET /v1/companies/acme-sl?as_of=2022-03-01 → published BORME history showed by that date

51 emitted act types, one vocabulary

Dense gazette shorthand becomes a closed, documented enum — the same value for the same act since 2009, across every provincial dialect of the gazette.

INCORPORATIONAPPOINTMENTSTERMINATIONSINSOLVENCY_STATUSDISSOLUTIONCAPITAL_INCREASE CAPITAL_REDUCTIONCAPITAL_INCREASE_UNEXECUTEDDURATION_CHANGESUSPENSION_OF_PAYMENTSBANKRUPTCY_LEGACYFIRST_INSCRIPTIONMERGER_BY_ABSORPTIONMERGER_BY_UNIONTOTAL_SPIN_OFFPARTIAL_SPIN_OFFSEGREGATIONTRANSFORMATIONNAME_CHANGEADDRESS_CHANGEPURPOSE_CHANGEPURPOSE_EXTENSIONSTATUTORY_AMENDMENTSPOWERS_MODIFICATIONREVOCATIONSRE_ELECTIONSAPPOINTMENT_CANCELLATIONSSOLE_SHAREHOLDER_DECLARATIONSOLE_SHAREHOLDER_CHANGESOLE_SHAREHOLDER_STATUSSOLE_SHAREHOLDER_STATUS_LOSTINSOLVENCY_DECLARATIONPROVISIONAL_SHEET_CLOSURE_INSOLVENCYPROVISIONAL_SHEET_CLOSURE_TAXPROVISIONAL_SHEET_CLOSURE_NIF_REVOKEDREGISTRY_SHEET_REOPENEDCOMPANY_REACTIVATIONEXTINCTIONGLOBAL_TRANSFER_ASSETS_LIABILITIESBOND_ISSUECALLED_UP_CAPITAL_PAIDBAD_DEBT_WRITE_OFFACCOUNTS_NON_APPROVAL_JUSTIFICATIONLEGAL_ADAPTATIONBRANCHFOREIGN_BRANCH_FIRSTCOMPANY_WEBSITEPREVENTIVE_ANNOTATIONSOLE_TRADERERRATUMOTHER

Auditable by design

Registry data is only useful if you can defend it. Every record retains official-source provenance — the gazette issue, act number and source link — alongside the normalized value. Anything unrecognized remains available as raw text rather than becoming an invented fact.

SOURCE

Official BOE open-data API

Fetched politely from boe.es — the state publisher of BORME. Every event links back to its gazette file and act number.

DETERMINISM

No LLM in the hot path

A deterministic parser over a closed vocabulary. Identical input yields identical output, byte for byte, on every re-run.

HONESTY

Source before inference

Parse completeness is measured per file. API events retain the publication reference and act number so an uncertain normalization can be checked against the BOE source.

IDENTITY

Stable event IDs

event_id is a deterministic hash — deduplicate across re-runs and replays with confidence.

COMPLETENESS

Reconciled against the registry itself

Creations, dissolutions and capital changes match the Colegio de Registradores' own annual totals to within about one percent, every complete year from 2016 to 2025. Control figures: opendata.registradores.org (ODbL 1.0).

Why pay?

The public facts are public. Payment funds the maintained processing that makes them dependable in a product: ingestion, normalization, entity resolution, historical replay, daily operation and delivery.

INGEST

Collect and preserve

We follow the official publication stream, retain the source reference and make the dated record queryable.

NORMALIZE

Make notices usable

A repeatable parser turns provincial gazette shorthand into typed events, roles and fields without hiding the original text.

RESOLVE

Show candidates honestly

Name, hoja, NIF and OEPM relationships have different strengths; the API exposes provenance and ambiguity instead of claiming certainty it does not have.

REPLAY

Serve history and change

We maintain replays, snapshots, watchlists and delivery so your team can ask a past question and receive new publication events.

Start today — actor or hosted API

Choose the Actor for an on-demand date-range export. Choose the maintained Hosted API for repeated lookups, derived company state, NIF mappings, history, monitoring, risk and MCP.

Live now

Apify actor

$0.01 per run + $1.00 per 1,000 events
  • Any date range since 2009, any province
  • Filter by event type and company name
  • $0.01 per run, plus $1 per 1,000 delivered events
  • JSON / CSV / Excel export, API & SDK access
  • Agent-friendly: limited permissions, typed output
Open in Apify Store
Live

Hosted API

API tiers

Free · €0
Explore
  • 50 requests/day
  • 7-day event history
  • 2 watchlists
  • Daily CSV subscription endpoint, subject to its subscription limits
Basic · €19/mo + VAT
Resolve
  • 5,000 requests/day
  • 365-day event history
  • 20 watchlists
  • Company snapshots; single NIF and hoja resolution; people roles and brands
  • Webhooks and email alerts
Pro · €49/mo + VAT
Reconstruct
  • 50,000 requests/day
  • Full archive since 2009
  • 200 watchlists
  • Batch NIF, as-of state, officer network and on-demand bulk CSV dump
Risk · €149/mo + VAT
Investigate
  • 200,000 requests/day
  • Full archive since 2009
  • 200 watchlists
  • Everything in Pro, plus signals and itemized, rule-based risk profiles
  • AEAT large-debtor-list cross-reference; not a credit rating or tax-debt check

All plans return the same sourced, typed records; the paid tiers add maintained resolution, replay, monitoring and delivery depth.

What the Hosted API adds

The free event feed lets you inspect recent sourced records. Paid tiers add indexed company resolution, derived state, monitoring, point-in-time history and risk outputs without requiring you to rebuild the publication pipeline.

Prices exclude VAT; Paddle adds it at checkout for your country (€19/mo is €22.99 incl. VAT in Spain). EU businesses with a VAT ID are charged net. Confirm your email for a free key, shown once in your account · 14-day refund on paid plans.
Get a sign-in link

Confirm your email to get a free key. Your key is shown only in your account.

Questions

Is this the official registry?

BORME is Spain's official commercial-registry gazette and publishes notices about appointments, capital changes, insolvency proceedings and other company events. This service normalizes that published history; it is not affiliated with or endorsed by BOE, and it is not a certified registry extract. Verify legal conclusions against the official notice or Registro Mercantil documents.

How fresh is the data?

BORME is normally published Monday to Friday. Events become available after BOE publication and successful ingestion; each processed record carries its publication date, gazette ID and source reference.

How far back does it go?

To the first digital BORME issue, January 2, 2009. The actor accepts any date range; the hosted API serves the full archive with company timelines on the Pro tier.

What about GDPR and personal names?

BORME is public-sector information whose publication is required by Spanish law; director names are part of the official record. We honor documented suppression requests for derived outputs — write to [email protected] and we will mask the affected person going forward.

build 2026.09.10·9f6407e