Clinical Intelligence StandardsVersion 0.2

Functional standard / How they are / PatientInstance

Condition

A diagnosis or problem. Recording one is a clinical decision.

Kind
condition
Collection
/v1/conditions
Initial state
active
Classification
Clinical

Scope and usage

The problem list. Verification may be provisional or confirmed. Resolution is a state change, not a delete.

Boundaries and relationships

Resource content

Elements this resource adds. It also carries the Instance, including patient_id.

NameCard.TypeFlagsDescription
code1..1code—Problem code.
display0..1string—Label.
system0..1code—Code system.
verification1..1codeBprovisional or confirmed.
onset0..1dateTime—When it began, if known.
severity0..1string—A label. The graded state over time is ClinicalState.
encounter_id0..1id—Encounter in which it was recorded.
notes0..1string—Short note. The narrative belongs on a NotePage.

State machine

active → remission, resolved, entered_in_error. remission → active, resolved. resolved → active.

Frozen: None. Not deletable.

Terminology bindings

ElementStrengthValues
verificationrequiredprovisional | confirmed

Invariants

Operations

MethodPathMeaning
GET/v1/conditionsList condition. Filter by patient_id, status, and where the model has them, encounter_id or definition_key.
POST/v1/conditionsCreate a condition. Body is the resource minus harness-owned elements.
GET/v1/conditions/{id}Read one condition.
PATCH/v1/conditions/{id}Update elements that are not immutable, frozen, or harness-owned.
POST/v1/conditions/{id}/transitionMove status. Body is { to, reason }. A gated move returns 202 and an Approval.

Example

{ "patient_id": "pat_…", "code": "mdd", "display": "Major depressive disorder", "verification": "provisional" }