Spanish company lookup by CIF or name

The two endpoints most integrations start with: the company record for a CIF, and a name search that returns candidates with their CIF.

Base URL: https://spaincompanyapi.com/api/v1 · API key in the X-API-KEY header · Get a free API key (100 requests, no card) · Full documentation

3. Lookup by CIF

Retrieve the complete profile of a company by providing its CIF or NIF.

GET /companies

Parameters

Field Type Description
cif string Required. The company CIF/NIF (e.g. B12345678).
admin boolean Optional. If true, includes current directors and officers (appointments minus the removals, resignations and revocations published in the BORME). Pro

Success response (200 OK)

{
  "success": true,
  "data": {
    "cif": "B12345678",
    "name": "EMPRESA DE EJEMPLO SL",
    "status": "ACTIVA",
    "status_code": "ACTIVE",
    "status_source": "registry",
    "status_date": "2011-02-03",
    "tax_id_revocation": null,
    "province": "MADRID",
    "cnae": "6201",
    "cnae_label": "Actividades de programación informática",
    "financials": {
      "size_band": "GT_1M",
      "size_band_label": "Más de 1 M€",
      "last_accounts_year": 2023
    },
    "identifiers": {
      "lei": "5493000EJEMPLO000000",
      "lei_status": "ISSUED",
      "lei_next_renewal_date": "2027-03-15",
      "lei_source": "gleif",
      "lei_as_of": "2026-10-15"
    },
    "legal_form": {
      "code": "SL",
      "label": "Sociedad limitada",
      "iso20275": "DP3Q",
      "source": "name"
    },
    "group": {
      "direct_parent": { "lei": "5493000MATRIZ0000000", "name": "GRUPO EJEMPLO SA", "country": "ES", "cif": "A12345674" },
      "ultimate_parent": { "lei": "5493000MATRIZ0000000", "name": "GRUPO EJEMPLO SA", "country": "ES", "cif": "A12345674" },
      "source": "gleif",
      "as_of": "2026-10-15"
    },
    "ownership": {
      "unipersonal": true,
      "sole_shareholder": {
        "name": "GRUPO EJEMPLO SA",
        "type": "company",
        "since": "2021-06-14",
        "url_pdf": "https://www.boe.es/borme/dias/2021/06/14/pdfs/BORME-A-2021-111-28.pdf"
      },
      "source": "borme",
      "as_of": "2021-06-14"
    },
    "size": {
      "employees_min": 10,
      "employees_max": 49,
      "label": "De 10 a 49 empleados",
      "category": "small",
      "source": "kit_digital",
      "as_of": "2024-05-14"
    },
    "address_density": {
      "active_companies_at_address": 63,
      "level": "mass",
      "match": "exact_address",
      "as_of": "2026-10-19"
    },
    "sources": {
      "registry": { "source": "borme", "as_of": "2026-09-22", "url_pdf": "https://www.boe.es/borme/dias/2026/09/22/pdfs/BORME-A-2026-180-28.pdf", "fields": ["name", "founded", "corporate_purpose"] },
      "status": { "source": "registry", "as_of": "2011-02-03" },
      "identifiers": { "source": "gleif", "as_of": "2026-10-15" },
      "legal_form": { "source": "name", "as_of": null },
      "group": { "source": "gleif", "as_of": "2026-10-15" },
      "ownership": { "source": "borme", "as_of": "2021-06-14", "url_pdf": "https://www.boe.es/borme/dias/2021/06/14/pdfs/BORME-A-2021-111-28.pdf" },
      "size": { "source": "kit_digital", "as_of": "2024-05-14" },
      "address_density": { "source": "apiempresas", "as_of": "2026-10-19" },
      "administrators": { "source": "borme", "as_of": "2026-09-22" }
    },
    "administrators": [
      {
        "name": "JUAN PÉREZ GARCÍA",
        "position": "Adm. Unico",
        "since": "2019-03-01",
        "url_pdf": "https://www.boe.es/borme/dias/2019/03/01/pdfs/BORME-A-2019-42-28.pdf"
      }
    ]
  }
}

* 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 Pro size_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.

🚀 Ready to get started?

Get your API Key in seconds and start integrating real data into your applications.

Go to Control Panel
🤖
Asistente IA En línea
¡Hola! Soy el asistente de APIEmpresas. ¿En qué puedo ayudarte hoy?