---
title: "Read the latest dated platform-coverage observation"
method: GET
path: "/api/v1/platform-stats"
tags: ["Platform truth"]
---

# Read the latest dated platform-coverage observation

`GET /api/v1/platform-stats`

## Request

- Base URL: `https://fonteum.com`
- URL: `https://fonteum.com/api/v1/platform-stats`
- Auth: none required

Returns the latest stored platform observation. The observation date is not an upstream refresh date; each source follows its own release and loaded-data cadence.

## Response `200`

Dated platform metrics and their source labels.

- PlatformStatsObservation: Latest usable platform-stats v3 snapshot. Every numeric metric value and numeric platform_coverage field is as of as_of; independently dated counts in description prose retain their own stated date. The query returns three source-lifecycle counts plus a separate state Medicaid jurisdiction count. Aggregate source completeness is not computed: platform_coverage.sources_complete is null. metrics is empty and platform_coverage is null when no snapshot contains all required query fields; no compile-time count is substituted.
  - `as_of` string, date, nullable, required: Observation date that qualifies every metrics[].value and each numeric platform_coverage field in this response.
  - `captured_at` string, date-time, nullable, required
  - `from_fallback` boolean, required
  - `groups` object[], required
  - `metrics` object[], required
    - `key` 'sources_integrated' | 'sources_with_data' | 'sources_fresh' | 'states_covered' | 'provenance_claims' | 'entities' | 'nppes_providers' | 'part_d_records' | 'open_payments' | 'state_licenses' | 'sam_exclusions' | 'sam_agencies' | 'oig_leie' | 'state_exclusions' | 'clinical_trials' | 'nih_projects', required
    - `label` string, required
    - `group` string, required
    - `value` integer, required: Numeric metric value as of the response as_of date.
    - `estimated` boolean, required
    - `source` string, required
    - `description` string, required
  - `platform_coverage` PlatformCoverage, required: Query-derived platform coverage from one public.platform_stats_snapshots row. The numeric coverage fields sources_integrated, sources_with_data, sources_fresh, and states_covered are as of as_of_date. Integrated, data-bearing, and fresh-observation counts are distinct. sources_complete is always null because the platform publishes no aggregate complete-source count. states_covered is a separate state Medicaid jurisdiction measure. The containing platform_coverage property is null when the read falls back or when any required query metric is absent.
    - `as_of_date` string, date, required: Observation date that qualifies sources_integrated, sources_with_data, sources_fresh, and states_covered in this object.
    - `captured_at` string, date-time, required: When the platform-stats observation was captured; not an upstream source-refresh timestamp.
    - `sources_integrated` integer, required: As of the sibling as_of_date: active production source-registry rows. Integration does not imply a loaded or fresh source.
    - `sources_with_data` integer, required: As of the sibling as_of_date: distinct snapshot source IDs with at least one positive record count.
    - `sources_fresh` integer, required: As of the sibling as_of_date: distinct snapshot source IDs whose latest positive-data snapshot date is within the preceding 45 days. Recency does not prove a content change or serving state.
    - `sources_complete` null, nullable, required: No platform-wide source-completeness count is published. Completeness is source-specific and must be evaluated against the named source's expected scope.
    - `states_covered` integer, required: As of the sibling as_of_date: distinct state values represented in the state Medicaid exclusions serving table.
    - `definitions` object, required
      - `sources_integrated` string, required
      - `sources_with_data` string, required
      - `sources_fresh` string, required
      - `sources_complete` string, required
      - `states_covered` string, required
    - `provenance` object, required
      - `source` string, required
      - `source_url` string, uri, required
      - `dataset_id` string, required
      - `snapshot` string, date, required
      - `last_checked` string, date-time, required
      - `methodology` string, required
      - `limitations` string, required
  - `_note` string

---

[API](https://skmtc.dev/fonteum/apis/fonteum-api.md) · [All operations](https://skmtc.dev/fonteum/apis/fonteum-api/llms.txt) · [OpenAPI document](https://skmtc.dev/fonteum/apis/fonteum-api/revisions/334e6e179d0d?raw)