Sign in

v2

latestOpenAPI 3.1.0Source-specific upstream terms; see response catalog metadata2026-07-26139203447.9 KB
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
}