System

Published public-dataset counters

Changed on Jul 26, 2026

Return the number of legal entities actually published in the active company_public_v2 sidecar, plus an optional offline person-mention approximation. It never exposes the raw 2.8M-row companies population and never runs a request-path COUNT. Sidecar unavailability is 503, not a zero/null company count.

get/api/v1/stats

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

Headers

If-None-Matchstring

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

Response

Stats response

total_companiesinteger required

company_public_projection_state.row_count for the active bundle

total_persons_approxinteger nullable required

person_count_source'person_public_v1' | 'null' nullable required

Null means person authority unavailable; never reinterpret as zero.

person_public_source_generationstring nullable required

built_atstring date-time required

timestampstring date-time required

version'1.2' required

count_source'company_public_v2' required

Example response

{
  "total_persons_approx": 970000
}

Changes

Jul 26, 2026996f96a11758 Revision changes
- breaking
  the response property became nullable for the status
- info
  api operation id getStats 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 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
  the response property became required for the status
- info
  the response property became required for the status
- info
  the response property became required for the status
- info
  the response property became required for the status
- info
  the response property became required for the status
- info
  the response property const value 1.2 was added for 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