v2

latestOpenAPI 3.1.0Source-specific upstream terms; see response catalog metadata2026-07-26139203447.9 KB

Search published Spanish legal entities

Corporate-only search over the immutable company_public_v2 projection. It resolves an exact corporate CIF, an exact canonical/safe-alias slug, or a bounded name-prefix pool. DNI/NIE, malformed identifier-shaped input and ambiguous/quarantined CIFs return zero items; there is no raw companies/search_idx or disk-index fallback.

get/api/v1/search

Query parameters

qstring required

Example:mercadona

Search query: company name, alias or CIF.

limitinteger

Maximum number of results.

offsetinteger

Bounded pagination offset. Values above 1000 fail with 422; future deep pagination requires a generation-bound cursor.

Headers

If-None-Matchstring

Optional RFC 9110 entity-tag validator. Weak validators, comma-separated validator lists and * are accepted.

Response

Search results

querystring required

countinteger required

offsetinteger

Example response

{
  "items": [
    {
      "slug": "mercadona-sa",
      "name": "MERCADONA SA",
      "cif": "A46103834"
    }
  ]
}