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
- Severity grading over time is ClinicalState, one current state per condition.
- A cohort is not a condition. Enrolling is CohortMembership.
Resource content
Elements this resource adds. It also carries the Instance, including patient_id.
| Name | Card. | Type | Flags | Description |
|---|---|---|---|---|
| code | 1..1 | code | — | Problem code. |
| display | 0..1 | string | — | Label. |
| system | 0..1 | code | — | Code system. |
| verification | 1..1 | code | B | provisional or confirmed. |
| onset | 0..1 | dateTime | — | When it began, if known. |
| severity | 0..1 | string | — | A label. The graded state over time is ClinicalState. |
| encounter_id | 0..1 | id | — | Encounter in which it was recorded. |
| notes | 0..1 | string | — | Short note. The narrative belongs on a NotePage. |
State machine
active/ initial — On the problem list.remission— Quiet, may return to active.resolved— Closed. May be reactivated.entered_in_error— Recorded by mistake.
active → remission, resolved, entered_in_error. remission → active, resolved. resolved → active.
Frozen: None. Not deletable.
Terminology bindings
| Element | Strength | Values |
|---|---|---|
| verification | required | provisional | confirmed |
Invariants
ccs-cond-1— Only a clinician creates or transitions a condition. A reaction or agent creates a Proposal.
Operations
| Method | Path | Meaning |
|---|---|---|
| GET | /v1/conditions | List condition. Filter by patient_id, status, and where the model has them, encounter_id or definition_key. |
| POST | /v1/conditions | Create 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}/transition | Move 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" }