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.

Partner API 0.1.0-draft.3 · Draft contract · Sandbox and SDK availability require confirmation.