Companies

Get the CNMV listed-company projection and recent events

Changed on Jul 26, 2026

Read only company_integrations_public_v1 after company_public_v2 admission. Returns one minimized listing tuple and up to 20 attested documentary events. It does not certify current supervision or imply a negative fact; empty coverage is not proof of non-listing.

get/api/v1/company/{slug}/cnmv

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/company/:slug/cnmv/get.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

slugstring required

Exact corporate slug admitted by company_public_v2; no empty segments, leading/trailing hyphen or repeated separator.

Query parameters

limitinteger

Headers

If-None-Matchstring

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

Response

CNMV listed-company projection or its documented empty shape

projection_status'available' required

slugstring required

cifstring required

complete_bounded_projectiontrue required

coverage_status'available' | 'empty' required

coverage_noticestring required

events_totalinteger required

returned_events_countinteger required

documentary_noticestring required

_attributionsobject

Changes

Jul 26, 2026996f96a11758 Revision changes
- breaking
  for the path request parameter slug, the minLength was increased from 0 to 1
- breaking
  added the pattern ^[a-z0-9]+(?:-[a-z0-9]+)*$ to the path request parameter slug
- info
  api operation id getCompanyBySlugCnmv 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 header request parameter If-None-Match
- info
  added the new optional query request parameter limit
- 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 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 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
- 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
- info
  added the required property to the response with the status

Operation history