Read observations, snapshots and evaluations
Choose the resource that matches the evidence you need.
| Resource | Meaning |
|---|---|
/users/{userId}/summary |
Proposed presentation of current values, scores, insights and counts. |
/users/{userId}/observations |
Proposed source history with metric and time filters. |
/users/{userId}/timeseries |
Proposed aggregated chart data; check allowed aggregations per metric. |
/users/{userId}/snapshots/latest |
Latest immutable patient evidence set. |
/users/{userId}/snapshots/{snapshotId} |
Exact evidence snapshot for a report or analysis. |
/users/{userId}/sources |
Source revisions already accepted by Health Atlas. |
/users/{userId}/observation-bundles/{bundleId} |
One exact source-owned immutable publication. |
The original simplified Observation model and the evidence-preserving EvidenceObservation projection are distinct schemas in this draft. Do not assume their values are interchangeable.
Preserve clinical qualifiers
{
"decimal": "4.500",
"comparator": "lt",
"unit": "mg/dL"
}
This quantity means less than 4.500 mg/dL. Preserve the comparator and decimal string. Source units, unresolved conversion, specimen and method affect interpretation; a catalog's preferred unit does not justify inventing a conversion.
A ClinicalDate can identify an unknown date, year, month, day or instant. A year-only event must not be rendered as if it happened at midnight on 1 January. Assertion, experiencer and temporality distinguish a current patient observation from family history, a denied symptom or a possible finding.
Use snapshot identity for reproducibility
Snapshot responses include id, evidenceVersion, algorithmVersion, source revisions and omissions. An access_scoped projection is not the complete original snapshot. Grants apply at read time even to historical evidence.
Omissions describe observations excluded because evidence remains unresolved. Missing evidence, an explicit absence and an omission are different states. An empty ready snapshot is also distinct from data that has not been assembled.
Read pattern evaluations
GET /users/{userId}/pattern-evaluations
GET /users/{userId}/pattern-evaluations/{snapshotId}
On completion, results identify the snapshot, rule revision, evaluator version and as-of time. Each pattern is match, no_match or indeterminate, with supporting evidence IDs and reasons. Indeterminate remains visible when evidence is missing or unresolved.
This endpoint exposes the existing biomarker matching foundation. It does not promise a diagnosis, an overall health score or ranked patient causal hypotheses. Complete-input access is required so results cannot leak denied evidence indirectly.
Clinical scores, recommendations and goal evaluation in the broader draft require separate product readiness and intended-purpose assessment. Their presence in the API reference is not confirmation of implementation.