* The administrators array is only included if you send admin=true and your plan supports it.
Data Dictionary (Schema)
Field
Type
Description
cif
string
The normalised Tax Identification Code (Spanish CIF/NIF).
name
string
The official company name as registered in the BORME.
status
enum
Status as it appears in the Registry, not normalised (e.g. ACTIVA, Activa, Extinción). May be empty. In your code, use status_code.
status_code
enum
Normalised status: ACTIVE (active in the Registry), PRESUMED_ACTIVE (no status in the Registry, other Registry data present and no BORME event that closes it), INSOLVENCY (insolvency proceedings in progress), IN_LIQUIDATION, DISSOLVED, REGISTRY_CLOSED (registry sheet closed), MERGED (absorbed), INACTIVE, EXTINCT or UNKNOWN (not enough data to decide, e.g. UTE joint ventures or records with no Registry data). All plans.
tax_id_revocation
object | null
Revocation or reinstatement of the tax ID (NIF) by the Spanish Tax Agency, as published in the BOE (new on 2026-11-06, all plans). status: REVOKED (revoked: not valid for tax purposes, and banks cannot make payments to or from its accounts) or REHABILITATED (revoked and later reinstated); date (BOE date), boe_id, boe_url and source (boe). null if the BOE has never published anything about that NIF. In /companies/verify a revoked NIF raises the TAX_ID_REVOKED alert and decision_hint: fail; in /companies/verify/batch, invoice_hint: no_facturar.
status_source
string | null
Where status_code comes from: registry (Registry status) or borme_analysis (reading of the BORME acts, which prevails when there is a more serious event than the registered status).
status_date
date | null
Date of the status, when known.
status_confidence
string | null
How much to trust status_code (new on 2026-11-03, all plans): high, medium or low; null when the status is UNKNOWN. It does not change the status: it flags when it may be out of date. The reasons are in status_confidence_reasons: RECENT_REGISTRY_ACT or NO_RECENT_REGISTRY_ACT (whether the company has published in the BORME in the last 5 years), DATED_REGISTRY_EVENT, NO_STATUS_DATE, OLD_INSOLVENCY (insolvency over 3 years old with no published conclusion), ACTIVITY_AFTER_STATUS (it kept filing acts more than a year later), REVERSIBLE_STATUS (registry sheet closed), PRESUMED_STATUS and NOT_FROM_COMMERCIAL_REGISTRY (INACTIVE comes from public sources, not the Commercial Registry). Measured status accuracy: data sources.
status_confidence_reasons
array[string]
Reasons for status_confidence (see above). Empty when the status is UNKNOWN.
financials
object
Prosize_band: indicative revenue band (LT_500K, 500K_1M, GT_1M or NO_REVENUE; null if unknown), with its label in size_band_label. last_accounts_year: latest financial year with filed accounts in our database (a later one may exist that we have not loaded yet).
identifiers
object
The company's LEI from GLEIF (all plans). lei (null if it has none), lei_status as GLEIF gives it (ISSUED current, LAPSED not renewed, RETIRED…), lei_next_renewal_date, lei_source and lei_as_of (date of the GLEIF copy). Mostly held by mid-size and large companies and by those active in financial markets.
legal_form
object
Legal form (all plans). code (SL, SA, SLP, SLL, SCOOP, AIE, UTE, FUNDACION…), label (in Spanish), iso20275 (ISO 20275 ELF code, as used by GLEIF and KYB systems; null when the form has no code of its own, e.g. SLNE or UTE) and source: name (read from the company name) or cif (inferred from the CIF letter when the name does not say).
group
object | null
Pro Direct parent (direct_parent) and ultimate parent (ultimate_parent) reported by the company to GLEIF, each with lei, name, country and cif (when it is a Spanish company in our database). null if the company has no LEI; both parents null if it has an LEI but reports no parent.
ownership
object
Pro Sole shareholder according to the BORME. unipersonal: true, false or null (unknown). sole_shareholder: name, type (company or person), since and url_pdf (official BORME PDF), or null. source: borme (latest published single-member act) or name (only the name says SLU or SAU; the shareholder is not on record). In Spain only the shareholder of single-member companies is public: the shareholders of companies with several members and the beneficial owner are not published.
size
object | null
Pro Headcount band (new on 2026-10-19). employees_min and employees_max, label, category (micro under 10, small 10 to 49, medium 50 to 249, large 250 or more; EU SME definition), source and as_of. Sources: kit_digital and kit_consulting (the band the company declared when it received the Red.es grant, as of the grant date) and ted or placsp (large company, "not an SME", according to its public contract awards; no headcount). null when there is no data: it is never estimated.
address_density
object | null
Pro Shared registered address (new on 2026-10-19). active_companies_at_address: active companies with exactly the same address, floor and door included (this one counts if active). level: normal, shared (10 or more: an accountant or law firm that provides registered addresses) or mass (50 or more: a registered-address centre). match: exact_address. as_of: date of the count (rebuilt weekly). It is a conservative count: the same address written in very different ways counts separately, and office towers do not add up because each company has its own floor. null when the address cannot be compared (no street number, or no postcode or municipality). For KYB: a mass address is not fraud, but you should check where the company actually operates.
province
string
Spanish province where the registered office is located.
cnae / cnae_label
string
CNAE industry code for the primary economic activity and its full descriptive label.
sources
object
Where each block comes from and how current it is (all plans; new on 2026-10-18). Each entry has source and as_of, and some have url_pdf. registry: legal name, incorporation and corporate purpose (fields), as of the company's latest BORME notice (as_of), with its official PDF in url_pdf (Pro, Business or credits); if the entity does not publish in the BORME (associations, foundations, public bodies…), source is other_public_sources. status, identifiers, legal_form, group, ownership, size and address_density repeat the source and date of their block. With admin=true, administrators: the list is the one in force per the BORME on that date. CNAE, address, coordinates and financials are compiled from several public sources and have no entry of their own (see data sources). It only adds information: no other field changes.
administrators[]
array[object]
Current directors and officers: appointments and re-elections published in the BORME minus later removals, resignations and revocations (none for a dissolved-and-struck-off company). Each object contains name, the title (position; comma-separated if several), since, the date of the current appointment (null if it predates our BORME history), and url_pdf, the official BORME PDF of that appointment (null if not available). If the person holds several positions, since and url_pdf refer to their earliest current appointment.
Data on the Free plan
On the Free plan (without prepaid credit) the response has the same structure, with these cuts:
address contains the text *** [ACTUALIZA A PRO PARA VER LA DIRECCION ].
corporate_purpose is cut to 100 characters when longer.
lat and lng are not included.
An upsell_opportunities object is added. If your code needs to know whether the response is trimmed, check for that field.
financials is not included. Inside upsell_opportunities, datos_pro says whether a revenue band and accounts year exist, and how many people currently hold a board position (excluding attorneys-in-fact; admin=true on Pro also returns the other posts).
group and ownership are not included. datos_pro says whether a sole shareholder is on record (socio_unico) and whether the company reports a parent to GLEIF (grupo_empresarial).
size and address_density are not included. datos_pro says whether a headcount band exists (tamano_empresa) and whether 10 or more active companies share the registered address (domicilio_compartido).
status_code, status_source, status_date, status_confidence, identifiers (LEI) and legal_form are returned as on paid plans.
sources is returned as well, except registry.url_pdf (null) and the group, ownership, size and address_density entries, which are not included.
With a Pro or Business plan, or with prepaid credit, you get the full data without changing your code.
4. Search by Name
Search for companies matching a name or business name. Without multiple it returns the best match, favouring companies registered in the Registry over UTE joint ventures and records without data.
GET/companies/search
Parameters
Field
Type
Description
name
string
Required. The name or partial name to search for. (Alias: q)
multiple
boolean
Optional. Without it (or with false) data is a single object: the best match. With true, data is a list and pagination goes in meta.
limit
integer
Optional, only with multiple=true. Results per page (default 20, up to 100).
page / cursor
integer / string
Optional, only with multiple=true. Page to request, or meta.next_cursor from the previous response. With cursor, send the same limit as in the first request too: otherwise 20 is used.
List of matching companies, with the same fields as /companies (without directors): cif, name, status, status_code, province…
meta.page
integer
Current page of search results.
meta.limit
integer
Maximum number of results per page.
meta.has_more
boolean
Indicates whether more results exist for the current search.
Data on the Free plan
On the Free plan (without credits), the same cuts as /companies: address hidden, corporate_purpose cut to 100 characters, no lat, lng or financials, and an upsell_opportunities object (campos_ocultos, mensaje and upgrade_url) on each company. On Pro, Business or with credits, full data.
¡Hola! Soy el asistente de APIEmpresas. ¿En qué puedo ayudarte hoy?
Consultando...
Legal
Privacy Policy
How we collect, use, and protect your information.
1. Identity of the Data Controller
The data controller of the personal data collected on this platform is Ariel Martinez Hernandez (hereinafter, "SpainCompanyAPI"), with NIF 54994158P and address at República Dominicana 40, Bajo E, 28983, Parla (Madrid). You can contact us at soporte@apiempresas.es.
2. Purposes and Legal Basis
We process your personal data for the following purposes and legal bases:
Provision of the service and account management: Necessary for the performance of the contract (Terms of Use) upon registration.
Billing and collections: Compliance with legal and tax obligations.
Fraud prevention and security: Based on our legitimate interest to keep the platform secure.
Commercial communications and marketing: We rely on our legitimate interest to send you information about products or services similar to those contracted. You can object to this processing by checking the corresponding box during registration or unsubscribing at any time.
3. Data Retention
The data will be kept as long as you maintain your account active and it is necessary to provide the service. Once canceled, they will be kept duly blocked for the period required by applicable legislation (generally up to 5 years for tax and legal reasons).
4. Recipients and International Transfers
We do not sell your data to third parties. We may transfer them to strictly necessary providers (hosting, analytics, payment gateway such as Stripe). Some of these providers (e.g., Google, GitHub) may transfer data outside the EEA. We ensure they comply with the GDPR through standard contractual clauses or equivalent agreements.
Cloudflare Turnstile: We use Cloudflare Turnstile to protect our forms against spam and automated abuse. The use of Turnstile is subject to the Cloudflare Privacy Policy and Terms.
5. Your Rights (ARCO-POL)
You have the right to obtain confirmation as to whether we are processing your data. You also have the right to:
Access your personal data.
Request its rectification if it is inaccurate.
Request its deletion when it is no longer necessary.
Request the limitation or object to its processing.
Request data portability.
You can exercise them by sending an email to soporte@apiempresas.es. Likewise, if you consider that your data has not been properly processed, you have the right to file a claim with the Spanish Data Protection Agency (AEPD).
Last updated: 11/16/2026
Legal
Legal Notice & Terms of Use
Legal conditions for accessing and using the platform.
1. General Information (LSSI-CE)
In compliance with Law 34/2002 on Information Society Services and Electronic Commerce (LSSI-CE), it is reported that the owner of the SpainCompanyAPI web platform is:
Owner: Ariel Martinez Hernandez
NIF: 54994158P
Address: República Dominicana 40, Bajo E, 28983, Parla (Madrid)
Contact: soporte@apiempresas.es
2. Acceptance
By accessing or registering on the service, you acquire the status of User and accept these terms of use in their entirety. If you do not agree, do not use the platform.
3. Permitted Use Conditions
You agree to make appropriate and lawful use of the service. It is strictly prohibited to:
Attempt to access systems or data without authorization.
Interfere with operation by abusing rate limits, malicious scraping, or cyber attacks.
Use the service for illegal purposes or those that harm the rights of third parties.
4. Account and Security
You are solely responsible for maintaining the confidentiality of your credentials (password, API keys) and for all activity that occurs under your account.
5. Intellectual Property
All content on the platform (design, code, structure, and databases) is the exclusive property of Ariel Martinez Hernandez or has the corresponding licenses. Reproduction, distribution, or modification is not allowed without express authorization.
6. Limitation of Liability
The platform is provided "as is." Within the applicable legal framework, SpainCompanyAPI is not liable for direct or indirect damages derived from the use of information obtained through the API, nor for potential service interruptions due to external causes.
7. Jurisdiction and Applicable Law
These conditions are governed by Spanish law. For the resolution of any dispute derived from the use of the service, the parties submit to the courts and tribunals of the city of Madrid, expressly waiving any other jurisdiction that may apply.