Spain

This guide is outdated and will be removed on 1 November 2026. The up-to-date Spain reference is on the Spain country page.

Start here

This guide contains public integration notes for Spain. Use it for identifier formats, search behavior, and country-specific caveats. The live source of truth for coverage, pricing, data sources, documents, legal forms, roles, and status values is the pricing page.

Spain coverage, pricing, and sources

Open the current catalog for supported datapoints, documents, sources, identifiers, and availability.

Country details below are preserved as integration notes. If a table or example conflicts with the live pricing page, use the pricing page as the source of truth and contact support.

Data Sources

Spain uses four data sources for company information. Structured profile data comes from a public registry portal, document retrieves from an authenticated electronic portal, supplementary data from the BORME (official commercial gazette), and foundations from the Registro de Fundaciones.

Structured Profile Data

OpenData Registradores (opendata.registradores.org). Operated by the Colegio de Registradores de la Propiedad y Mercantiles de Espana. This is the primary source for structured company profile data: company name (denominacion social), legal form (forma social), status (estado), NIF, IRUS, EUID, registered address (domicilio social), share capital, CNAE_2009 activity code, legal representatives (administradores/cargos), and incorporation date (constitucion). Data is extracted from the registry.

Document Retrieval

SEDE Electronica del Colegio de Registradores (sede.registradores.org). The official electronic portal of the Colegio de Registradores. Used for search/NIF resolution (to obtain the IRUS identifier) and document retrieval: trade register extracts (Nota Informativa Mercantil) and financial statements (Deposito de Cuentas). Documents are retrieved with real-time pricing and delivered as PDFs.

Documents are priced in real time by the register, and prices vary with the size of a company’s registry history. Documents priced above €200 by the register are not offered by default: they are excluded from availableDocuments and cannot be ordered. This ceiling exists to keep document pricing predictable; it can be raised on demand for your account — contact us.

BORME (Supplementary)

BORME (Boletin Oficial del Registro Mercantil). Spain’s official commercial gazette, published daily. Used as a supplementary enrichment source for company profiles (activity descriptions, director appointment dates) and as the source of sole shareholder information. When the register lists a company without an internal register reference, its company details and officer history come from BORME, provided a matching BORME record is found.

Registro de Fundaciones (Foundations)

Registro de Fundaciones de Competencia Estatal (Ministerio de Justicia). Spain’s national register of state-level foundations. Foundations carry a NIF beginning with G and resolve through this register instead of the mercantile sources above. G is not only foundations (savings banks, many economic interest groupings, UTEs, pension funds and mutual guarantee companies carry it too): a G NIF the foundation register does not hold is served from the mercantile sources. It returns the legal name, NIF, registration number, constitution and registration dates, registered seat, purposes (fines), and the governing board (patronato) plus senior management as legal representatives. The legal form is Fundación. A printable Foundation Register Extract of the public profile is available under documents.tradeRegisterExtract.

Foundations have no shareholders or beneficial owners. The patronato is the governing body, not an ownership structure, so shareholders returns a datapoint_not_applicable outcome for foundations. Coverage is limited to foundations of state competence (those operating across more than one autonomous community). Foundations registered only in a regional (autonomous-community) register are not covered.

Search uses SEDE for NIF resolution. Name and NIF searches query SEDE to resolve the company’s IRUS identifier, then OpenData is queried for structured profile data using that IRUS.

Company Identifiers

Query Identifiers

Identifier Type	Format	Example	Notes
NIF/CIF	Letter + 7 digits + check character (digit or letter); the 7 digits can start with 0	`A82511361`	Primary company identifier for all API operations. Returned as the register records it: a few register records hold a NIF with a character missing (e.g. `A5859731` for `A58597311`)
DNI (individual entrepreneurs)	8 digits + check letter	`12345678Z`	For autonomous workers / sole proprietors
VAT	ES + NIF	`ESA82511361`	Automatically stripped to NIF for search
Hoja registral	Province code (1 or 2 letters) + hyphen + sheet number	`M-213521`	Mercantile Register sheet reference. A trailing control digit, as published in LEI/GLEIF records (`M-213521-8`), is accepted and stripped

Primary Identifier: We use NIF (Numero de Identificacion Fiscal) as the company ID for all Spanish entities.NIF is the standard Spanish tax identification number. For legal entities, the first letter indicates the legal form (Orden EHA/451/2008):

A: Sociedad Anonima (SA)
B: Sociedad Limitada (SL)
C: Sociedad Colectiva
D: Sociedad Comanditaria
E: Comunidad de bienes and other entities without legal personality
F: Cooperatives
G: Associations and, before 2008, other entity types. Foundations carry G and resolve through the Registro de Fundaciones; a G NIF that is not a foundation is served from the mercantile register
H: Comunidad de propietarios
J: Sociedad Civil
N: Foreign entities
P: Local corporations
Q: Public bodies
R: Religious congregations and institutions
S: State and regional administration bodies
U: Temporary business associations (UTE)
V: Other entity types
W: Permanent establishments of non-resident entities

Identifiers in API Response

Once you retrieve company data, the identifiers object contains all available identifiers for that entity:

Identifier Type	Format	Example	Found In
`nif`	Letter + 7 digits + check character (digit or letter), or 8 digits + check letter for a natural person	`A82511361`	All companies
`VAT`	NIF value (without ES prefix)	`A82511361`	All companies
`euid`	Country prefix + register code + entity number	`ES28.RM-M28038019301`	When published in the OpenData extract
`hoja`	Province code (1 or 2 letters) + hyphen + sheet number	`M-213521`	When the company is matched in the BORME gazette

VAT value in the API response does NOT include the ES prefix. The identifiers.VAT field contains only the NIF value itself (e.g., A82511361). The country prefix ES is stored separately in taxId.country. This is consistent with how other EU countries handle VAT numbers.

Legal Entity Identifier (LEI)

GLEIF is the supplementary data source for this identifier. company.identifiers.lei is optional. It is returned when the NIF (nif) or mercantile-register sheet (hoja) matches exactly one LEI through a GLEIF registration or validation reference. A trailing control digit on a GLEIF hoja reference is ignored when matching it to the register sheet. The Legal Entity Identifier has 20 uppercase alphanumeric characters, ending in two check digits. Coverage varies by entity. An absent lei does not prove that the company has no LEI. Lapsed, retired or merged LEIs may be returned; annulled LEIs are excluded.

Search Capabilities

Search automatically detects the identifier type and routes to the appropriate handler:

Search Type	Pattern	Example	Match Type	Expected Results
By NIF/CIF	Letter + 7 digits + check character (digit or letter)	`A82511361`	Exact	Exact match returned first (matchType: id); other results may follow
By DNI	8 digits + check letter	`12345678Z`	Exact	Exact match returned first (matchType: id); other results may follow
By VAT Number	ES + NIF	`ESA82511361`	Exact	Exact match returned first (matchType: id, ES prefix stripped); other results may follow
By IRUS	13 digits	`1000263762669`	Exact	Exact match returned first (matchType: id); other results may follow
By hoja registral	Province code + sheet number, optional control digit	`M-213521-8`	Exact	The company holding that Mercantile Register sheet (matchType: id). Useful for resolving the Spanish “Registration Authority Entity ID” found in LEI records
By Name	Text string	`"Telefonica"`	Fuzzy	Multiple results (deduplicated by NIF)

Search Performance: Use identifier-based searches (NIF, VAT) for best performance and exact matching. Name searches query SEDE which returns paginated results that are deduplicated by NIF using a scoring algorithm that filters out branches and selects the main entity.

Branch filtering: When multiple IRUS entries exist for the same NIF (e.g., branches, offices, agencies), the system uses a scoring algorithm to select the main entity. Branch keywords such as SUCURSAL, URBANA, AGENCIA, OFICINA, and DELEGACION receive a heavy penalty. Current (active) status and shorter names (likely parent entities) receive a bonus.

Active companies only

Search can return companies that are no longer active. activeOnly=true removes those whose status is known at search time; the others are kept. Only foundations found by name are filtered (an extinguished foundation is removed). Company searches, and NIF lookups of foundations, return the entity whatever its status.

Quirks & Gotchas

Quirk	Details
NIF is the primary ID	Unlike some countries that use a separate registry number, Spain uses the NIF (tax ID) as the company identifier for all API operations.
IRUS is internal only	The IRUS (Identificador Unico del Registro de Sociedades) is a 13-digit internal registry identifier used for OpenData lookups and document retrieval. It should not be used as a query identifier by API consumers.
VAT = ES + NIF	Spanish VAT numbers are simply the NIF prefixed with “ES”. Having a NIF does not guarantee the company is VAT-registered — companies must be in the ROI (Registro de Operadores Intracomunitarios) for EU cross-border trade. VIES will return invalid for companies not in ROI.
Document prices are dynamic	Trade register extract and financial statement prices are fetched in real-time from SEDE and may vary. Prices appear in the `price` field before purchase.
€200 document price ceiling	Documents priced above €200 by the register (rare — a handful in two years, typically companies with very large registry histories) are not listed and cannot be ordered by default. The ceiling can be raised on demand per account.
Shareholders only for unipersonal companies	Ownership is public only when a company has a single member (socio único), published in BORME. That member is returned as one shareholder holding 100%. Companies with several shareholders publish no ownership, so `shareholders` is returned empty.
No UBO data	Ultimate Beneficial Owner data is not publicly available through the commercial registry.
SEDE document retrieves	Document retrieves are processed through the official SEDE portal of the Colegio de Registradores.
”Liquidada” covers every closed sheet	OpenData shows “Liquidada” for a liquidated company, a company absorbed in a merger and a closed branch alike, and keeps “Vigente” for a company still in liquidation.
OpenData data extraction	Company data is extracted from the OpenData Registradores portal.
Multiple IRUS per NIF	Large companies (e.g., banks) can have dozens of IRUS entries for the same NIF, representing branches and offices in different provinces. The NIF resolver scoring algorithm selects the main entity.
Document delivery is asynchronous	After retrieving a document from SEDE, there may be a short delay before the PDF is available for download.
BORME as supplementary source	BORME gazette data enriches company profiles with activity descriptions, director appointment dates, and sole shareholder information.

Company Status

Company status comes from the OpenData Registradores Estado field and from the acts published in the BORME. Every value is mapped deterministically to an active flag and a standardized status.

Status Mapping

Local Status	Source	Standardized Status	`active`	Notes
Vigente	OpenData, foundations	Active	`true`	Register sheet in force. A company in liquidation keeps this status until its sheet closes.
Liquidada	OpenData	Closed	`false`	Closed register sheet: liquidated, absorbed in a merger, or a closed branch. No closure reason is given.
En situación concursal	OpenData (“Concurso”), BORME	Under Insolvency Proceeding	`false`	Insolvency proceedings.
Disuelta	BORME	Closed	`false`	Dissolution act published.
Extinguida	BORME, foundations	Closed	`false`	Extinction act published, or extinction date recorded for a foundation.
Unknown	OpenData	—	`false`	The register shows no state for the sheet.

The BORME closes a company (dissolution, extinction, insolvency) but never reopens one: when the BORME records no such act, the register’s own state stands. The status list is published on the pricing page. A state the register shows that is not listed above keeps its wording and is classified automatically.

Legal Forms

Spanish company law makes the legal form part of the company name (“S.L.”, “Sociedad Anónima”, “S.Coop.”, …), so the legal form is read from the name. When the name carries no form, it is read from the OpenData Registradores “Forma social”, which is a register category (“Sociedades de responsabilidad limitada”, “Sociedades anónimas”, …) and is returned as the form it denotes. Failing both, the first letter of the NIF gives it (A sociedad anónima, B sociedad limitada, C sociedad colectiva, D sociedad comanditaria, F cooperativa, J sociedad civil, U UTE, W permanent establishment); that letter also tells a sociedad colectiva from a sociedad civil when the name only says “S.C.”. The mapping is deterministic: each form has a fixed English translation, standardized type and, where GLEIF lists one, an ISO 20275 (ELF) code.

Spanish Legal Form (`localName`)	Abbreviation	English	Standardized	ISO 20275
Sociedad Limitada	SL	Limited liability company	Limited Liability Company	`DP3Q`
Sociedad de Responsabilidad Limitada	SRL	Limited liability company	Limited Liability Company	`DP3Q`
Sociedad Limitada Nueva Empresa	SLNE	New enterprise limited liability company	Limited Liability Company	—
Sociedad Limitada Profesional	SLP	Professional limited liability company	Limited Liability Company	`JB2M`
Sociedad de Responsabilidad Limitada Profesional	SRLP	Professional limited liability company	Limited Liability Company	`JB2M`
Sociedad Limitada Laboral	SLL	Employee-owned limited liability company	Limited Liability Company	`1G29`
Sociedad de Responsabilidad Limitada Laboral	SRLL	Employee-owned limited liability company	Limited Liability Company	`1G29`
Sociedad Limitada Laboral Profesional	SLLP	Professional employee-owned limited liability company	Limited Liability Company	—
Sociedad Anónima	SA	Public limited company	Corporation	`5RDO`
Sociedad Anónima Deportiva	SAD	Sports public limited company	Corporation	—
Sociedad Anónima Laboral	SAL	Employee-owned public limited company	Corporation	`R2L8`
Sociedad Anónima Profesional	SAP	Professional public limited company	Corporation	`AJ9U`
Societas Europaea	SE	European company	Corporation	`9FPZ`
Sociedad por Acciones Simplificada	SAS	Simplified joint-stock company	Corporation	—
Sociedad de Inversión de Capital Variable	SICAV	Investment company with variable capital	Corporation	`8EHB`
Sociedad Comanditaria Simple	SCOM	Limited partnership	Partnership	`TDD5`
Sociedad Comanditaria por Acciones	SCOMPA	Partnership limited by shares	Partnership	`GJL1`
Sociedad Regular Colectiva	SRC	General partnership	Partnership	`S6X7`
Sociedad Civil	SC	Civil partnership	Partnership	`2W1A`
Sociedad Civil Profesional	SCP	Professional civil partnership	Partnership	`2W1A`
Unión Temporal de Empresas	UTE	Temporary business association	Partnership	—
Agrupación de Interés Económico	AIE	Economic interest grouping	Partnership	`I2WU`
Agrupación Europea de Interés Económico	AEIE	European economic interest grouping	Partnership	`BI3B`
Sociedad Cooperativa	SCOOP	Cooperative	Cooperative	`1QU8`
Sociedad de Garantía Recíproca	SGR	Mutual guarantee company	Other	`IAS6`
Fondo de Inversión	FI	Investment fund	Other	`S0Z5`
Fondo de Pensiones	FP	Pension fund	Other	`FH4R`
Sociedad Mercantil Estatal	SME	State-owned company	Government-Owned Entity	—
Emprendedor de Responsabilidad Limitada	ERL	Limited liability entrepreneur	Sole Proprietorship	`IT6N`
Sucursal en España	SUCURSAL	Branch in Spain	Branch or Representative Office	—
Besloten Vennootschap	BV	Private limited company (Netherlands / Belgium)	Limited Liability Company	—
Naamloze Vennootschap	NV	Public limited company (Netherlands / Belgium)	Corporation	—
Limited Company	LTD	Private limited company	Limited Liability Company	—
Caja de Ahorros	CAJA	Savings bank	Other	`4S57`
Cooperativa de Crédito	SCOOPCRED	Credit cooperative	Cooperative	`SS0L`
Fundación	FUNDACION	Foundation	Nonprofit Organization	`MDOL`

Single-member companies are returned under their form: an “S.L.U.” is a Sociedad Limitada and an “S.A.U.” a Sociedad Anónima. A company whose name and register category both carry no recognisable form keeps the register’s wording, with a standardized type.

Legal Representatives and Other Key Persons

Legal representatives come from the OpenData Registradores “Administradores y cargos” section, the BORME appointment acts and, for foundations, the Registro de Fundaciones. Registered administrators, delegated directors, attorneys and liquidators appear under legalRepresentatives. Office-only board members, secretaries, auditors, foundation trustees, substitute officers and owners appear under otherKeyPersons. A board or trustee appointment does not by itself establish individual signing authority. General managers and insolvency administrators also require the applicable mandate or court regime; an office label alone is insufficient. The register may omit the detailed signing mandate, restrictions or co-signatories. The registers print the same office many ways (BORME abbreviates it, OpenData capitalises it at will, the foundation register uses feminine forms and ordinals such as “Presidenta” or “Vicepresidente 1º”). Each is returned under one sentence-case label, with a fixed English translation and standardized role:

All Spanish roles

Spanish Role (`localName`)	English	Standardized	Response list
Administrador	Director	Director	`legalRepresentatives`
Administrador único	Sole director	Director	`legalRepresentatives`
Administrador solidario	Joint and several director	Director	`legalRepresentatives`
Administrador mancomunado	Joint director	Director	`legalRepresentatives`
Administrador conjunto	Joint director	Director	`legalRepresentatives`
Administrador suplente	Alternate director	Other	`otherKeyPersons`
Administrador solidario suplente	Alternate joint and several director	Other	`otherKeyPersons`
Administrador mancomunado suplente	Alternate joint director	Other	`otherKeyPersons`
Consejero	Board member	Board Member	`otherKeyPersons`
Consejero delegado	Managing director	Managing Director	`legalRepresentatives`
Consejero delegado solidario	Joint and several managing director	Managing Director	`legalRepresentatives`
Consejero delegado mancomunado	Joint managing director	Managing Director	`legalRepresentatives`
Consejero delegado mancomunado solidario	Joint and several managing director	Managing Director	`legalRepresentatives`
Consejero ejecutivo	Executive director	Other	`otherKeyPersons`
Consejero dominical	Proprietary director	Non-Executive Director	`otherKeyPersons`
Consejero independiente	Independent director	Non-Executive Director	`otherKeyPersons`
Consejero coordinador	Lead independent director	Non-Executive Director	`otherKeyPersons`
Consejero externo	External director	Non-Executive Director	`otherKeyPersons`
Consejero suplente	Alternate board member	Board Member	`otherKeyPersons`
Consejero rector	Member of the governing council	Board Member	`otherKeyPersons`
Vocal	Board member	Board Member	`otherKeyPersons`
Presidente	Chairman	Chairman of the Board	`otherKeyPersons`
Vicepresidente	Vice-chairman	Vice Chairman of the Board	`otherKeyPersons`
Secretario	Secretary	Secretary	`otherKeyPersons`
Secretario no consejero	Non-director secretary	Secretary	`otherKeyPersons`
Vicesecretario	Vice-secretary	Secretary	`otherKeyPersons`
Vicesecretario no consejero	Non-director vice-secretary	Secretary	`otherKeyPersons`
Tesorero	Treasurer	Other	`otherKeyPersons`
Suplente	Alternate	Other	`otherKeyPersons`
Miembro del consejo rector	Member of the governing council	Board Member	`otherKeyPersons`
Miembro del consejo rector suplente	Alternate member of the governing council	Board Member	`otherKeyPersons`
Presidente del consejo rector	Chairman of the governing council	Chairman of the Board	`legalRepresentatives`
Vicepresidente del consejo rector	Vice-chairman of the governing council	Vice Chairman of the Board	`otherKeyPersons`
Secretario del consejo rector	Secretary of the governing council	Secretary	`otherKeyPersons`
Tesorero del consejo rector	Treasurer of the governing council	Other	`otherKeyPersons`
Miembro del comité ejecutivo	Member of the executive committee	Other	`otherKeyPersons`
Presidente del comité ejecutivo	Chairman of the executive committee	Other	`otherKeyPersons`
Miembro del comité de auditoría	Member of the audit committee	Auditor	`otherKeyPersons`
Miembro del comité de control	Member of the control committee	Supervisor	`otherKeyPersons`
Presidente del comité de control	Chairman of the control committee	Other	`otherKeyPersons`
Secretario del comité de control	Secretary of the control committee	Secretary	`otherKeyPersons`
Miembro de la comisión de control	Member of the control commission	Supervisor	`otherKeyPersons`
Director	Manager	Other	`otherKeyPersons`
Director general	General manager	C-Level Executive	`otherKeyPersons`
Director gerente	Managing director	Other	`otherKeyPersons`
Gerente	Manager	Other	`otherKeyPersons`
Gerente único	Sole manager	Other	`otherKeyPersons`
Apoderado	Attorney-in-fact	Authorized Signatory	`legalRepresentatives`
Apoderado general	General attorney-in-fact	Authorized Signatory	`legalRepresentatives`
Apoderado solidario	Joint and several attorney-in-fact	Authorized Signatory	`legalRepresentatives`
Apoderado mancomunado	Joint attorney-in-fact	Authorized Signatory	`legalRepresentatives`
Apoderado mancomunado solidario	Joint and several attorney-in-fact	Authorized Signatory	`legalRepresentatives`
Apoderado conjunto	Joint attorney-in-fact	Authorized Signatory	`legalRepresentatives`
Apoderado de sucursal	Branch attorney-in-fact	Authorized Signatory	`legalRepresentatives`
Representante	Representative of a corporate director	Other	`legalRepresentatives`
Representante de sucursal	Branch representative	Authorized Signatory	`legalRepresentatives`
Representante fiscal	Tax representative	Other	`otherKeyPersons`
Representante del plan	Pension plan representative	Other	`otherKeyPersons`
Auditor	Auditor	Auditor	`otherKeyPersons`
Auditor de cuentas	Statutory auditor	Auditor	`otherKeyPersons`
Auditor titular	Statutory auditor	Auditor	`otherKeyPersons`
Auditor suplente	Alternate auditor	Auditor	`otherKeyPersons`
Auditor individual	Individual auditor	Auditor	`otherKeyPersons`
Auditor conjunto	Joint auditor	Auditor	`otherKeyPersons`
Auditor de cuentas consolidadas	Auditor of the consolidated accounts	Auditor	`otherKeyPersons`
Auditor de cuentas consolidadas conjunto	Joint auditor of the consolidated accounts	Auditor	`otherKeyPersons`
Auditor suplente de cuentas consolidadas	Alternate auditor of the consolidated accounts	Auditor	`otherKeyPersons`
Liquidador	Liquidator	Liquidator	`legalRepresentatives`
Liquidador único	Sole liquidator	Liquidator	`legalRepresentatives`
Liquidador solidario	Joint and several liquidator	Liquidator	`legalRepresentatives`
Liquidador mancomunado	Joint liquidator	Liquidator	`legalRepresentatives`
Liquidador suplente	Alternate liquidator	Other	`otherKeyPersons`
Liquidador judicial	Court-appointed liquidator	Liquidator	`legalRepresentatives`
Liquidador concursal	Insolvency liquidator	Liquidator	`legalRepresentatives`
Administrador concursal	Insolvency administrator	Other	`otherKeyPersons`
Representante del administrador concursal	Representative of the insolvency administrator	Other	`otherKeyPersons`
Administrador judicial	Court-appointed administrator	Administrator	`legalRepresentatives`
Interventor	Court-appointed supervisor	Supervisor	`otherKeyPersons`
Interventor judicial	Court-appointed supervisor	Supervisor	`otherKeyPersons`
Mediador concursal	Insolvency mediator	Other	`otherKeyPersons`
Socio	Partner	Other	`otherKeyPersons`
Socio fundador	Founding partner	Other	`otherKeyPersons`
Socio miembro	Member partner	Other	`otherKeyPersons`
Socio profesional	Professional partner	Other	`otherKeyPersons`
Socio único profesional	Sole professional partner	Other	`otherKeyPersons`
Entidad gestora	Management company	Manager	`legalRepresentatives`
Entidad depositaria	Depositary	Other	`otherKeyPersons`
Entidad promotora	Sponsor	Other	`otherKeyPersons`
Entidad de registro contable	Book-entry registration entity	Other	`otherKeyPersons`
Comisario	Bondholders’ commissioner	Other	`otherKeyPersons`
Delegado	Delegate	Other	`otherKeyPersons`
Promotor	Promoter	Other	`otherKeyPersons`
Patrono	Trustee	Board Member	`otherKeyPersons`
Secretario no patrono	Non-trustee secretary	Secretary	`otherKeyPersons`

An office printed in a form not listed above keeps the register’s wording, and its standardized role is classified automatically.

Shareholders

Shareholders are included in the company data block. Spanish ownership is public only for unipersonal companies (SLU, SAU): when BORME records a sole member (socio único), that member is returned as a single shareholder holding 100%. Companies with several shareholders publish no ownership information, so shareholders is returned empty for them. For foundations, shareholders returns a datapoint_not_applicable outcome.

Activity Code Mapping

Spain uses the CNAE_2009 (Clasificacion Nacional de Actividades Economicas) classification, which is the Spanish national adaptation of the European NACE standard. The system maps activity codes across three levels:

CNAE_2009 2009 (Spanish) -> NACE Rev. 2.1 (European) -> ISIC Rev. 5 (International)

Classification	Source	Example	AI Inferred?
CNAE_2009	OpenData Registradores	`6201`	No (official)
NACE	Derived from the CNAE_2009 code, then converted to NACE Rev. 2.1	`62.10`	No
ISIC	Derived from NACE through the official NACE/ISIC correspondence	`621`	No (normally)

OpenData Registradores publishes the CNAE_2009 code only. The NACE code is derived from it and converted to NACE Rev. 2.1, and the ISIC Rev. 5 code comes from the official NACE to ISIC correspondence, so both normally carry isAIInferred: false. AI matching is used only as a last resort when no formal correspondence exists, and the isAIInferred flag is then true. Each classification is published once, under CNAE_2009, NACE or ISIC.

Main activity: OpenData Registradores publishes a single CNAE_2009 code per company (the “actividad principal”), so it is by definition the main activity. The CNAE_2009 and NACE entries carry isMainActivity: true, and the ISIC code derived from them inherits the flag.

Activity Code Fields

OpenData Registradores provides the CNAE_2009 code. NACE and ISIC are derived from it:

Field	Classification	Example Value
CNAE_2009	CNAE_2009 2009	`6201 Actividades de programacion informatica`
NACE	NACE Rev. 2.1	`62.10 Computer programming activities`
ISIC	ISIC Rev. 5	`621 Computer programming activities`

Data Availability Matrix

Data Type	Commercial Companies	Notes
Company Profile	✅ Async	Full structured data from OpenData Registradores
Legal Representatives	✅	Directors and officers from OpenData
Other Key Persons	✅	Board, secretarial, audit, trustee, substitute and ownership appointments without established individual representation
Shareholders	✅ (sole shareholder only)	Sole member of a unipersonal company, from BORME. Empty for companies with several shareholders
Ultimate Beneficial Owners	❌	Not publicly available
Establishments	❌	Not available through OpenData
Activity Codes	✅	CNAE_2009 from OpenData, NACE and ISIC derived through official correspondences
Trade Register Extract	✅ (Paid)	PDF from SEDE, real-time pricing
Financial Statements	✅ (Paid)	PDF per fiscal year from SEDE

Legend: ✅ Available | ❌ Not Available | Async = Asynchronous processing

Documents by Company Type

Documents are retrieved from SEDE Electronica del Colegio de Registradores with real-time pricing.

Commercial Companies (NIF)

Document Type	API Category	Format	Availability	Notes
Nota Informativa Mercantil (Trade Register Extract)	`tradeRegisterExtract`	PDF	✅ All companies	Real-time pricing from SEDE
Deposito de Cuentas (Financial Statements)	`financialStatements[]`	PDF	✅ When filed	Per fiscal year, real-time pricing

Document prices are fetched in real-time from SEDE and displayed in the price field before purchase. For trade register extracts, the following data segments are included: capital, social representation, administrators, and attorneys-in-fact.

Financial statement availability varies. Not all companies file their annual accounts (Deposito de Cuentas) with the Registro Mercantil. Available fiscal years are listed via a dropdown on SEDE. Each year’s price is determined individually.

Example API Responses

All examples use placeholder data. Query: POST /v2/company with { "id": "<NIF>", "countryCode": "ES", "dataPoints": ["company", "legalRepresentatives", "otherKeyPersons"] }

Active SA (Sociedad Anonima) -- with VAT verification

{
  "company": {
    "id": "A12345678",
    "countryCode": "ES",
    "identifiers": {
      "nif": "A12345678",
      "VAT": "A12345678",
      "euid": "ES28.RM-M28038019301"
    },
    "taxId": {
      "type": "eu_vat",
      "value": "A12345678",
      "country": "ES",
      "verification": {
        "status": "verified",
        "verifiedName": "EXAMPLE CORP SA",
        "verifiedAddress": "CALLE GRAN VIA 28, MADRID",
        "consultationNumber": "WAPIXXXXXXXXXXXX"
      }
    },
    "legalName": "Example Corp SA",
    "registrationDate": "2010-05-15",
    "status": {
      "localName": "Vigente",
      "active": true,
      "statusDetails": { "status": "ACTIVE" }
    },
    "legalForm": {
      "localName": "Sociedad Anónima",
      "standardized": "Corporation",
      "iso20275Code": "5RDO"
    },
    "capital": {
      "amount": 60000,
      "currency": "EUR"
    },
    "activities": {
      "CNAE_2009": [{ "code": "6201", "description": "Actividades de programacion informatica", "isAIInferred": false }],
      "NACE": [{ "code": "62.10", "description": "Computer programming activities", "isAIInferred": false }],
      "ISIC": [{ "code": "621", "description": "Computer programming activities", "isAIInferred": false }]
    },
    "legalAddress": {
      "addressLine1": "Calle Gran Via 28",
      "city": "Madrid",
      "postalCode": "28013",
      "countryCode": "ES"
    }
  },
  "legalRepresentatives": [
    {
      "entityId": "person_001",
      "type": "individual",
      "role": { "localName": "Administrador único", "standardized": "Director" },
      "individual": { "name": { "fullName": "Carlos Garcia Lopez" } }
    }
  ]
}

Active SL (Sociedad Limitada) -- multiple administrators

{
  "company": {
    "id": "B98765432",
    "countryCode": "ES",
    "identifiers": {
      "nif": "B98765432",
      "VAT": "B98765432"
    },
    "legalName": "Servicios Digitales SL",
    "registrationDate": "2018-11-20",
    "status": {
      "localName": "Vigente",
      "active": true,
      "statusDetails": { "status": "ACTIVE" }
    },
    "legalForm": {
      "localName": "Sociedad Limitada",
      "standardized": "Limited Liability Company",
      "iso20275Code": "DP3Q"
    },
    "capital": {
      "amount": 3000,
      "currency": "EUR"
    },
    "activities": {
      "CNAE_2009": [{ "code": "7022", "description": "Otras actividades de consultoria de gestion empresarial", "isAIInferred": false }],
      "NACE": [{ "code": "70.20", "description": "Business and other management consultancy activities", "isAIInferred": false }],
      "ISIC": [{ "code": "7020", "description": "Business and other management consultancy activities", "isAIInferred": false }]
    },
    "legalAddress": {
      "addressLine1": "Passeig de Gracia 100",
      "city": "Barcelona",
      "postalCode": "08008",
      "countryCode": "ES"
    }
  },
  "legalRepresentatives": [
    {
      "entityId": "person_001",
      "type": "individual",
      "role": { "localName": "Administrador solidario", "standardized": "Director" },
      "individual": { "name": { "fullName": "Ana Martinez Ruiz" } }
    },
    {
      "entityId": "person_002",
      "type": "individual",
      "role": { "localName": "Administrador solidario", "standardized": "Director" },
      "individual": { "name": { "fullName": "Pedro Sanchez Diaz" } }
    }
  ]
}

Closed company (Extinguida)

{
  "company": {
    "id": "B55667788",
    "countryCode": "ES",
    "identifiers": {
      "nif": "B55667788",
      "VAT": "B55667788"
    },
    "legalName": "Comercio Antiguo SL",
    "registrationDate": "2005-03-10",
    "status": {
      "localName": "Extinguida",
      "active": false,
      "statusDetails": { "status": "CLOSED" }
    },
    "legalForm": {
      "localName": "Sociedad Limitada",
      "standardized": "Limited Liability Company",
      "iso20275Code": "DP3Q"
    },
    "capital": {
      "amount": 3000,
      "currency": "EUR"
    },
    "activities": {
      "CNAE_2009": [{ "code": "4771", "description": "Comercio al por menor de prendas de vestir en establecimientos especializados", "isAIInferred": false }],
      "NACE": [{ "code": "47.71", "description": "Retail sale of clothing", "isAIInferred": false }],
      "ISIC": [{ "code": "4771", "description": "Retail sale of clothing, footwear and leather articles", "isAIInferred": false }]
    },
    "legalAddress": {
      "addressLine1": "Calle Serrano 45",
      "city": "Madrid",
      "postalCode": "28001",
      "countryCode": "ES"
    }
  },
  "legalRepresentatives": [
    {
      "entityId": "person_001",
      "type": "individual",
      "role": { "localName": "Liquidador", "standardized": "Liquidator" },
      "individual": { "name": { "fullName": "Maria Lopez Fernandez" } }
    }
  ]
}

Note: Closed companies have active: false and status Extinguida. Documents may still be available from SEDE.

VAT unverified (not in ROI)

{
  "company": {
    "id": "B11223344",
    "countryCode": "ES",
    "identifiers": {
      "nif": "B11223344",
      "VAT": "B11223344"
    },
    "taxId": {
      "type": "eu_vat",
      "value": "B11223344",
      "country": "ES",
      "verification": {
        "status": "unverified"
      }
    },
    "legalName": "Pequena Empresa SL",
    "registrationDate": "2020-07-01",
    "status": {
      "localName": "Vigente",
      "active": true,
      "statusDetails": { "status": "ACTIVE" }
    },
    "legalForm": {
      "localName": "Sociedad Limitada",
      "standardized": "Limited Liability Company",
      "iso20275Code": "DP3Q"
    }
  }
}

Note: VAT status is unverified because the company is not registered in the ROI (Registro de Operadores Intracomunitarios). This is common for small companies that do not engage in EU cross-border trade.

Available Documents

Documents are returned when "dataPoints": ["availableDocuments"] is requested.

API Category	Document	Notes
`tradeRegisterExtract`	Nota Informativa Mercantil (PDF)	Real-time pricing from SEDE
`financialStatements[]`	Deposito de Cuentas (PDF)	Per fiscal year, real-time pricing

Trade Register Extract segments included:

Capital social (share capital)
Representacion social (social representation)
Administradores (directors)
Apoderados (attorneys-in-fact)

Data Source Priority & Routing

For a given entity, the system follows this resolution flow:

Company Profile Resolution Flow:

SEDE search by NIF — Resolves the NIF to an IRUS identifier and returns search results. The resolver selects the main entity (filtering out branches).
OpenData lookup by IRUS — Retrieves structured data from OpenData Registradores (name, legal form, status, address, capital, CNAE_2009, officers, registration date). If SEDE lists the company but gives no IRUS, company details and officer history come from BORME instead, when a matching BORME record is found.
Enrichment — Legal form, status and roles are mapped deterministically from the register’s values; the address is AI-parsed into components. NACE and ISIC codes are derived from the CNAE_2009 code through the official correspondences.
VIES VAT validation — A qualified VIES check validates the VAT number and obtains a consultation number (legal proof for audits).

Document Resolution Flow:Documents are retrieved through the official SEDE portal of the Colegio de Registradores. Available document types include trade register extracts (Nota Informativa Mercantil) and financial statements (Deposito de Cuentas). Documents are delivered as PDFs after retrieval processing.

Attribute-Level Source Mapping

Attribute	Source	Notes
Company name (denominacion social)	OpenData	Official registry name
Legal form	OpenData and BORME (company name, then forma social, then NIF letter)	Deterministic: standardized type + ISO 20275
Status (estado)	OpenData; BORME closing acts take precedence	Deterministic: standardized status + `active` flag
Registered address (domicilio social)	OpenData	AI-enriched for structured address components
Share capital	OpenData	AI-formatted for standardization
CNAE_2009 activity code	OpenData	Official, never AI-inferred
NACE / ISIC activity codes	Derived	From the CNAE_2009 code through the official correspondences; AI only as a last resort
Legal representatives	OpenData	From cargos/administradores; roles mapped deterministically
Registration date (constitucion)	OpenData	Company formation date
NIF	OpenData / SEDE	From search results
IRUS	SEDE	Resolved during NIF search; internal reference, not returned in `identifiers`
EUID	OpenData	European Unique Identifier, when available
VAT verification	VIES	Qualified check with consultation number

Europe

North America

Asia

Offshore Centers

Start here

Spain coverage, pricing, and sources

Data Sources

Structured Profile Data

Document Retrieval

BORME (Supplementary)

Registro de Fundaciones (Foundations)

Company Identifiers

Query Identifiers

Identifiers in API Response

Legal Entity Identifier (LEI)

Search Capabilities

Active companies only

Quirks & Gotchas

Company Status

Status Mapping

Legal Forms

Legal Representatives and Other Key Persons

Shareholders

Activity Code Mapping

Activity Code Fields

Data Availability Matrix

Documents by Company Type

Commercial Companies (NIF)

Example API Responses

Data Source Priority & Routing

Attribute-Level Source Mapping

​Start here

Spain coverage, pricing, and sources

​Data Sources

​Structured Profile Data

​Document Retrieval

​BORME (Supplementary)

​Registro de Fundaciones (Foundations)

​Company Identifiers

​Query Identifiers

​Identifiers in API Response

​Legal Entity Identifier (LEI)

​Search Capabilities

​Active companies only

​Quirks & Gotchas

​Company Status

​Status Mapping

​Legal Forms

​Legal Representatives and Other Key Persons

​Shareholders

​Activity Code Mapping

​Activity Code Fields

​Data Availability Matrix

​Documents by Company Type

​Commercial Companies (NIF)

​Example API Responses

​Data Source Priority & Routing

​Attribute-Level Source Mapping

Start here

Data Sources

Structured Profile Data

Document Retrieval

BORME (Supplementary)

Registro de Fundaciones (Foundations)

Company Identifiers

Query Identifiers

Identifiers in API Response

Legal Entity Identifier (LEI)

Search Capabilities

Active companies only

Quirks & Gotchas

Company Status

Status Mapping

Legal Forms

Legal Representatives and Other Key Persons

Shareholders

Activity Code Mapping

Activity Code Fields

Data Availability Matrix

Documents by Company Type

Commercial Companies (NIF)

Example API Responses

Data Source Priority & Routing

Attribute-Level Source Mapping