---
title: "Spanish Company Data (x402)"
method: GET
path: "/x402/v2/spanish-company-data"
tags: ["x402"]
---

# Spanish Company Data (x402)

`GET /x402/v2/spanish-company-data`

## Request

- Base URL: `https://api.strale.io`
- URL: `https://api.strale.io/x402/v2/spanish-company-data`
- Auth: none required

Look up Spanish company data from the BORME-derived OpenMercantil register. Accepts CIF/NIF or company name. Returns identity, status, legal form, current officers (cargos) with roles, and BORME activity history for 2.8M+ Spanish companies.

## Query parameters

- `cif` string: Alias for nif
- `nif` string: Spanish CIF/NIF (letter + 7 digits + check char, e.g. A28015865); ES-prefixed VAT accepted
- `name` string: Alias for company_name
- `task` string: Free-text alias — CIF/NIF or company name
- `query` string: Free-text alias — CIF/NIF or company name
- `identifier` string: Alias for nif
- `vat_number` string: Alias for nif — ES-prefix VAT format accepted (ESA28015865)
- `company_name` string: Spanish company name (scored match — ambiguous names are refused, never guessed)

## Response `200`

Success

- object
  - `nif` string, nullable: CIF; can be null on name-path lookups when the BORME record carries no published CIF
  - `status` 'active' | 'inactive' | 'unknown' | 'null', nullable
  - `address` string, nullable
  - `province` string, nullable: Province with the most BORME filings for this company — an activity-location proxy, NOT the registered office
  - `legal_form` string, nullable
  - `legal_name` string
  - `status_raw` string, nullable: Native Spanish register status (Activa, Extinguida, ...)
  - `vat_number` string, nullable
  - `company_name` string
  - `company_type` string, nullable
  - `jurisdiction` string
  - `borme_acts_count` integer, nullable
  - `tier_2_available` boolean
  - `ubo_availability` string
  - `date_incorporated` string, nullable
  - `recent_borme_acts` unknown[]: Most recent BORME acts with per-act registral references (Sección/Hoja/Inscripción) — the primary-source trace for officer and status facts
    - unknown
  - `registration_date` string, nullable
  - `registered_address` string, nullable
  - `last_borme_activity` string, nullable
  - `first_borme_activity` string, nullable
  - `legal_representatives` unknown
  - `primary_registration_id` string, nullable
  - `tier_2_available_reason` string
  - `ubo_availability_reason` string
  - `total_legal_representatives` integer, nullable

## Other responses

- `402`: Payment required (x402 — pay with USDC on Base)

---

[API](https://skmtc.dev/strale/apis/strale-api-2.md) · [All operations](https://skmtc.dev/strale/apis/strale-api-2/llms.txt) · [OpenAPI document](https://skmtc.dev/strale/apis/strale-api-2/revisions/a5293878cfc6?raw)