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"
    }
  ]
}

Changes

Changed in 1 of the 3 revisions of this API.285

Jul 26, 2026996f96a11758285See the full diff
- ●
  for the query request parameter q, the maxLength was set to 120
  request-parameter-max-length-set
- ●
  for the query request parameter offset, the max was set to 1000.00
  request-parameter-max-set
- ○
  api operation id getSearch was added
  api-operation-id-added
- ○
  the endpoint scheme security apiKey was added to the API
  api-security-added
- ○
  the endpoint scheme security bearerAuth was added to the API
  api-security-added
- ○
  added the new optional header request parameter If-None-Match
  new-optional-request-parameter
- ○
  added the non-success response with the status 304
  response-non-success-status-added
- ○
  added the non-success response with the status 422
  response-non-success-status-added
- ○
  added the non-success response with the status 503
  response-non-success-status-added
- ○
  added the optional property _alias_of to the response with the 400 status
  response-optional-property-added
- ○
  added the optional property _alias_of to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property action to the response with the 400 status
  response-optional-property-added
- ○
  added the optional property action to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property allowed to the response with the 400 status
  response-optional-property-added
- ○
  added the optional property allowed to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property allowed_parameters to the response with the 400 status
  response-optional-property-added
- ○
  added the optional property allowed_parameters to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property code to the response with the 400 status
  response-optional-property-added
- ○
  added the optional property code to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property daily_limit to the response with the 400 status
  response-optional-property-added
- ○
  added the optional property daily_limit to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property date to the response with the 400 status
  response-optional-property-added
- ○
  added the optional property date to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property detail to the response with the 400 status
  response-optional-property-added
- ○
  added the optional property detail to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property fields to the response with the 400 status
  response-optional-property-added
- ○
  added the optional property fields to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property items/items/capital_cents to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property items/items/cnae_code to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property items/items/cnae_section to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property items/items/first_seen to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property items/items/matched_alias to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property items/items/province to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property key to the response with the 400 status
  response-optional-property-added
- ○
  added the optional property key to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property limit to the response with the 400 status
  response-optional-property-added
- ○
  added the optional property limit to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property limited_by to the response with the 400 status
  response-optional-property-added
- ○
  added the optional property limited_by to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property login_url to the response with the 400 status
  response-optional-property-added
- ○
  added the optional property login_url to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property max_bytes to the response with the 400 status
  response-optional-property-added
- ○
  added the optional property max_bytes to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property maximum to the response with the 400 status
  response-optional-property-added
- ○
  added the optional property maximum to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property needed to the response with the 400 status
  response-optional-property-added
- ○
  added the optional property needed to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property ok to the response with the 400 status
  response-optional-property-added
- ○
  added the optional property ok to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property parameter to the response with the 400 status
  response-optional-property-added
- ○
  added the optional property parameter to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property plan to the response with the 400 status
  response-optional-property-added
- ○
  added the optional property plan to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property projection to the response with the 400 status
  response-optional-property-added
- ○
  added the optional property projection to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property reason to the response with the 400 status
  response-optional-property-added
- ○
  added the optional property reason to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property remaining to the response with the 400 status
  response-optional-property-added
- ○
  added the optional property remaining to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property reset_at to the response with the 400 status
  response-optional-property-added
- ○
  added the optional property reset_at to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property reset_at_human to the response with the 400 status
  response-optional-property-added
- ○
  added the optional property reset_at_human to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property retry_after to the response with the 400 status
  response-optional-property-added
- ○
  added the optional property retry_after to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property retry_after_s to the response with the 400 status
  response-optional-property-added
- ○
  added the optional property retry_after_s to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property shortfall to the response with the 400 status
  response-optional-property-added
- ○
  added the optional property shortfall to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property slug to the response with the 400 status
  response-optional-property-added
- ○
  added the optional property slug to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property source_catalog_version to the response with the 400 status
  response-optional-property-added
- ○
  added the optional property source_catalog_version to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property status to the response with the 400 status
  response-optional-property-added
- ○
  added the optional property status to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property upgrade to the response with the 400 status
  response-optional-property-added
- ○
  added the optional property upgrade to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property upgrade_url to the response with the 400 status
  response-optional-property-added
- ○
  added the optional property upgrade_url to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property valid to the response with the 400 status
  response-optional-property-added
- ○
  added the optional property valid to the response with the 429 status
  response-optional-property-added
- ○
  the response property error became required for the status 400
  response-property-became-required
- ○
  the response property error became required for the status 429
  response-property-became-required
- ○
  the response property items/items/acts_count became required for the status 200
  response-property-became-required
- ○
  the response property items/items/cif became required for the status 200
  response-property-became-required
- ○
  the response property items/items/name became required for the status 200
  response-property-became-required
- ○
  the response property items/items/slug became required for the status 200
  response-property-became-required
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history