System

Published public-dataset counters

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

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

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

Jul 26, 2026996f96a11758116See the full diff
- ▲
  the response property total_persons_approx became nullable for the status 200
  response-property-became-nullable
- ○
  api operation id getStats 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 429
  response-non-success-status-added
- ○
  added the non-success response with the status 503
  response-non-success-status-added
- ○
  the response property built_at became required for the status 200
  response-property-became-required
- ○
  the response property timestamp became required for the status 200
  response-property-became-required
- ○
  the response property total_companies became required for the status 200
  response-property-became-required
- ○
  the response property total_persons_approx became required for the status 200
  response-property-became-required
- ○
  the response property version became required for the status 200
  response-property-became-required
- ○
  the version response property const value 1.2 was added for the status 200
  response-property-const-added
- ○
  added the required property count_source to the response with the 200 status
  response-required-property-added
- ○
  added the required property person_count_source to the response with the 200 status
  response-required-property-added
- ○
  added the required property person_public_source_generation to the response with the 200 status
  response-required-property-added
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history