Skip to main content

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/NACE activity codes, 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.

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 sole shareholder information.

Registro de Fundaciones (Foundations)

  • Registro de Fundaciones de Competencia Estatal (Ministerio de Justicia). Spain’s national register of state-level foundations. Companies whose NIF begins with G are foundations and resolve through this register instead of the mercantile sources above. 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 and ultimateBeneficialOwners are empty 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

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. The first letter indicates the entity type:
  • A: Sociedad Anonima (SA)
  • B: Sociedad Limitada (SL)
  • C-H: Other entity types (cooperatives, partnerships, etc.)
  • G: Associations and foundations (foundations resolve through the Registro de Fundaciones)
  • J: Sociedad Civil
  • N: Foreign entities
  • P: Local government bodies
  • Q: Public entities
  • R: Religious congregations
  • S: Government bodies
  • U: Temporary business associations (UTE)
  • V: Other unclassified entities
  • 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:
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.

Search Capabilities

Search automatically detects the identifier type and routes to the appropriate handler:
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.

Quirks & Gotchas

Company Status

Company status is determined from the OpenData Registradores estado field. The mapping is AI-enriched — no static codelist exists. The AI analyzes the local Spanish status string to produce a standardized status.

Status Mapping

The active boolean is true for statuses like “Vigente” and “Activa”, and false for all other status values. The standardized status classification is produced by AI enrichment.
Legal form standardization is AI-enriched. OpenData Registradores provides a free-text forma social field. The AI produces a standardized company type and an ISO 20275 (ELF) code.

Limited Companies (Sociedades Limitadas)

Corporations (Sociedades Anonimas)

Partnerships (Sociedades Personalistas)

Cooperatives & Special Forms

Investment & Financial Vehicles

Other Entity Types

Foreign Company Forms (registered in Spain)

The AI enrichment maps any forma social string from OpenData Registradores to a standardized type and ISO 20275 code. The local Spanish legal form name is always preserved verbatim.
Legal representatives are extracted from the OpenData Registradores administradores/cargos section. Role classification as legal representative vs. other key person is AI-enriched based on the role string and the company’s legal form context.

Role Types from OpenData

The classification of each role as legal representative or other key person is AI-enriched and depends on the company’s legal form context. For example, an “Administrador unico” is always a legal representative, while an “Apoderado” (attorney-in-fact) is typically classified as an other key person despite having signing authority. The AI uses the ISO 20275 (ELF) code of the company’s legal form to determine the appropriate classification.

Other Key Persons

Other key persons are extracted from the same OpenData cargos section as legal representatives. The AI enrichment determines which roles fall into this category based on the legal form context. Typical roles include board members (Consejero), secretaries (Secretario), attorneys-in-fact (Apoderado), and auditors (Auditor).

Shareholders

Shareholder data is not available for Spanish companies. The Spanish Registro Mercantil does not expose shareholder information through its public registry portals (OpenData or SEDE). Ownership data is only accessible through private filings and is not part of the publicly available dataset.

Activity Code Mapping

Spain uses the CNAE (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:
Both CNAE and NACE codes are provided directly by OpenData Registradores and are never AI-inferred. ISIC codes are always AI-inferred from the CNAE/NACE codes. Each activity item includes an isAIInferred flag to distinguish official vs. AI-derived codes.

Activity Code Fields

Activity codes are provided as two separate fields from OpenData Registradores:

Data Availability Matrix

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 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"] }
Note: Closed companies have active: false and status Extinguida. Documents may still be available from SEDE.
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.
Documents are returned when "dataPoints": ["availableDocuments"] is requested.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:
  1. SEDE search by NIF — Resolves the NIF to an IRUS identifier and returns search results. The resolver selects the main entity (filtering out branches).
  2. OpenData lookup by IRUS — Retrieves structured data from OpenData Registradores (name, legal form, status, address, capital, CNAE/NACE, officers, registration date).
  3. AI enrichment — Legal form, status, activities (ISIC), address, and capital formatting are enriched.
  4. 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