Schemas
| Schema | Required fields | Example | Validated |
|---|---|---|---|
| schema.json | version, dataset, observations, sources, facts, series, distributions | — | structural |
| observation.schema.json | id, metricId, subjectType, subjectId, value, asOf, sourceId, confidence, dataMode | example | ✓ all observations |
| source.schema.json | id, title, publisher, url, type | example | ✓ all sources |
| series.schema.json | id, title, metricId, subjectType, subjectId, unit, cadence, snapshots | — | ✓ all series |
| graph.schema.json | nodes, edges, summary | example | structural |
| diff.schema.json | version, previousVersion, frozenPreviousSnapshot, valueLevel | example | structural |
Schemas are conservative and additive (draft-07): they pin the required, stable fields and allow additional properties, so new export fields never break a consumer. Enums cover stable value sets (subject type, data mode, confidence, source type, cadence). Not a guarantee of completeness or real-time data.
Machine-readable: schema-report/data.json · see the data dictionary and the developer guide.