BORME API

Guides · Spanish company data

Which official Spanish and EU services provide programmatic access to company data, what each one covers, what none of them gives you, and what to ask a commercial provider before you pay

2026-11-16 · 9 min · guide

By BORMEAPI Engineering

If you are looking for one official endpoint that takes a Spanish company's tax number and returns its record, you will not find it among the services below. Spanish company data is spread over several public bodies: the commercial registries and their registrars, the official gazette of the register (the BORME), the central registry, the tax agency and, for listed companies, the securities regulator. Some of them offer machine access, some offer free look-ups for people, and some sell documents company by company.

This guide describes the official services as we checked them on 24 October 2026, then commercial providers, then where our own API fits. Every official service below links to its own page, so you can check the terms yourself before you build on it.

Official sources a program can call

The BORME open data API (state gazette agency)

The Agencia Estatal Boletín Oficial del Estado, which publishes the BORME, runs an open data service on boe.es. For the BORME it has one operation: the summary of a day's issue.

curl -L -H "Accept: application/json" \
  https://www.boe.es/datosabiertos/api/borme/sumario/20261023

Documentation: BOE open data, BORME FAQ and the API guide (PDF, first version dated 28 June 2024). Our article on what BORME is and how to read it shows what a notice looks like.

The registrars' free company directory

Since 9 May 2024, article 17.5 of the Commercial Code, as amended by Law 11/2023, requires the commercial register to provide certain data free of charge, either directly or through the European interconnection of business registers. The data are: name and legal form, registered office, the EU country of registration, registration number and European Unique Identifier (EUID), website, status (for example dissolved, liquidated, active or inactive), corporate purpose, the people currently authorised to represent the company as a body or as members of one, and whether they may act alone or must act jointly, and any branches in other EU countries, with their name, EUID and country. The website is included when it is recorded in the register.

The registrars serve these data in the company directory of their open data portal, opendata.registradores.org, which they describe as an initial approach to be completed gradually. It is built for people: one company at a time, with a picture you have to rotate upright before searching. It is a search form, not a documented API.

The same portal publishes statistical datasets that a program can download in CSV, ODS or XLSX: monthly incorporations and extinctions by province since 2011, filings of annual accounts, transfers of registered office and insolvency declarations. The incorporation, extinction and office-transfer datasets carry the Open Database License (ODbL 1.0). None of them is a company directory: they are counts, plus record-level files on office transfers and insolvency declarations whose listed variables do not include the company's name.

The registrars' paid services

For detailed registry information about one company, the registrars offer paid services: the informational extract (nota informativa, also called nota simple), the registry certificate and copies of deposited annual accounts. They are ordered company by company on the registrars' online office, sede.registradores.org, without a subscription, and frequent users can open a subscriber account. Only the certificate formally attests to what the register records.

The Registro Mercantil Central

The Registro Mercantil Central in Madrid centralises the data it receives from the territorial registries, for information purposes only, and issues the certificate that a company name is available. Its online information services about registered companies moved to the registrars' online office under Law 11/2023, and its website sends people looking for general company data to the free directory above.

The EU business register search

Since June 2017 the business registers of all EU countries have been interconnected through the Business Registers Interconnection System (BRIS), which can be searched on the European e-Justice portal. Article 17.5 provides for the basic data above to be available free through this interconnection. The portal provides a company search form.

datos.gob.es

datos.gob.es is Spain's national open data catalogue. Its API and SPARQL endpoint query the catalogue itself, the descriptions of datasets published by public bodies, not the data inside them. It is useful to discover datasets and then download them from the body that publishes them.

The CNMV

The securities regulator keeps official registers of securities issuers, listed companies, investment firms and collective investment schemes, which it states are public and accessible without restriction. They can be searched by entity on its website, and the CNMV publishes the periodic financial reports of listed issuers in XBRL and individual data files of collective investment schemes in XML. This covers only the entities the CNMV supervises.

The tax agency's NIF check

The Agencia Tributaria issues the NIF. What it offers developers is a check, not a company profile: given a NIF and, for an individual, their surnames and given name, it says whether they match its census. For a legal person, a single query requires only the NIF; if identified, the response returns the current NIF and registered name and indicates whether the entity is deregistered from the tax census or its NIF has been revoked. The check exists as a web form that accepts CSV files of up to 20,000 NIFs, and as a SOAP web service. The form accepts Cl@ve Móvil or an electronic certificate, including the electronic DNI; the web service requires an electronic certificate. The service's stated purpose is to validate taxpayers' identification data for tax compliance, and the manual warns that using it for other purposes can get access blocked.

VIES and GLEIF

Two services outside Spain return data about some Spanish companies:

What none of them gives you

Put together, the official services above leave one gap: none of them is a free API that takes a Spanish company's NIF, name or registry sheet and returns its record and its history. The free directory and the EU search answer people, one company at a time. The gazette API answers by date, not by company. The registrars' extracts, certificates and copies of accounts are paid and ordered company by company, and only the certificate formally attests to what the register records. The tax agency confirms a NIF and the name on record, and does not describe the company.

That gap is what commercial providers fill, in different ways.

Commercial providers

Commercial providers of Spanish company data fall into a few broad groups:

Prices and coverage differ widely, and the official services above are the yardstick. Whichever provider you are considering, including BORMEAPI, ask:

  1. Which sources? Registry documents, the BORME, accounts, the tax agency, or the provider's own research, and which of them for each field.
  2. How fresh? How long after a BORME issue or a registry filing a change appears.
  3. How far back? Whether history starts in 2009, when the BORME's electronic edition became the official one, or later.
  4. What does a NIF cover? The BORME does not consistently print the NIF, so a lookup by NIF covers only the companies the provider could match. Ask for the coverage, and what a miss means.
  5. Can you check it? Whether each record links to the official publication or document it came from.
  6. What does the licence allow? Storage, redistribution and use in your own product.

Where BORMEAPI fits

BORMEAPI is an API built on the gazette. It reads the company notices the BORME has published since 2009 and turns them into structured events grouped by company. Each event keeps the original Spanish text, labels the act type and roles in English, and carries the reference to the official notice it came from. On 30 October 2026, that came to more than 9.6 million events concerning more than 3.2 million companies, and the lookup by NIF covered more than 580,000 of them: a miss means we could not match that NIF, not that the company does not exist.

What each plan gives:

Annual billing is available on every paid plan. For AI assistants, an MCP endpoint at https://mcp.bormeapi.com/mcp offers tools for event search, company history and, from Basic up, lookups by NIF. Without a key it answers on the free plan's terms, with the daily quota counted per IP address; with a key, on that key's plan. For one-off exports by date, province or act type, our Apify actor charges $0.01 per run plus $1 per 1,000 delivered events.

GET /v1/events?province=MADRID&act_type=INCORPORATION
GET /v1/companies/by-nif/B12345674
GET /v1/companies/{slug}?as_of=2019-06-30

BORMEAPI is not a registry. It does not issue extracts or certificates, and it does not hold annual accounts or shareholder lists. It reports what the BORME published. When you need a document with legal force, ask the registry for it.

Get a free API key Read the API reference

build 2026.11.22·525b1737