Datasets

Request an offline company export artifact (currently unavailable)

Changed on Jul 26, 2026

The route preserves API credential, exports:read scope, paid-tier and action-budget checks, then always returns 503 offline_export_required. PHP-FPM never filters, sorts, paginates or serializes a bulk company export. The historical query parameters remain documented only so clients can remove them.

get/api/v1/export/companies

Request

Base URL
https://openmercantil.es
Auth
API key in header X-API-Key
TypeScript
https://skmtc.dev/openmercantil/apis/openmercantil-public-api/docs/api/v1/export/companies/get.ts
A function with typed inputs. Its response is checked against the schema.

Query parameters

provinciastring

Exact province value used by the company projection, or all.

tipostring

Company-form suffix filter such as SL, SA or SLU.

añostring

Four-digit first-seen year. The runtime parameter name contains ñ.

limitinteger

offsetinteger

formato'csv' | 'json'

Changes

Jul 26, 2026996f96a11758 Revision changes
- breaking
  removed the success response with the status
- warning
  deleted the query request parameter api_key
- info
  api operation id getExportCompanies was added
- info
  endpoint deprecated
- info
  added the new optional query request parameter año
- info
  added the new optional query request parameter formato
- info
  added the new optional query request parameter limit
- info
  added the new optional query request parameter offset
- info
  added the new optional query request parameter provincia
- info
  added the new optional query request parameter tipo
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  the response property became required for the status

Operation history