Get companies by CNAE sector code

Changed on Jul 26, 2026

Return companies belonging to a given CNAE (Clasificación Nacional de Actividades Económicas) sector. CNAE codes 1-4 digits (eg. 62 = programación, 6201 = programación informática).

get/api/v1/sector/{cnae}/companies

Request

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

Path parameters

cnaestring required

Example:62

Query parameters

limitinteger

offsetinteger

sort'acts' | 'recent' | 'oldest' | 'name'

With province only recent and oldest are accepted so the request stays index-backed.

provincestring

Response

Companies in sector

codestring required

countinteger nullable required

count_status'precomputed' | 'not_precomputed' required

limitinteger required

offsetinteger required

sortstring required

Example response

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

Changes

Jul 26, 2026996f96a11758 Revision changes
- breaking
  for the query request parameter limit, default value was changed from 50 to 20
- info
  api operation id getSectorByCnaeCompanies was added
- info
  the endpoint scheme security apiKey was added to the API
- info
  the endpoint scheme security bearerAuth was added to the API
- info
  added the new optional query request parameter offset
- info
  added the new optional query request parameter province
- info
  added the new optional query request parameter sort
- 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 required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status

Operation history