Functional standard / How they are / PatientInstance
ClinicalState
The current grading of a condition, or a general state such as emergency or pregnant.
- Kind
- clinical_state
- Collection
- /v1/clinical-states
- Initial state
- current
- Classification
- Clinical in some uses
Scope and usage
One current state for the general scope, and one current state per condition. A new current state supersedes the previous. Nothing is overwritten.
Boundaries and relationships
- The diagnosis is Condition. The score is Observation. This resource is the judgment of where they are.
Resource content
Elements this resource adds. It also carries the Instance, including patient_id.
| Name | Card. | Type | Flags | Description |
|---|---|---|---|---|
| scope | 1..1 | code | B | general or condition. |
| condition_code | 0..1 | code | — | Required when scope is condition. |
| state | 1..1 | code | — | For example moderate, severe, remission, emergency, pregnant. |
| grade | 0..1 | string | — | Optional grade label. |
| basis | 0..* | id | — | Observation or assessment ids this judgment rests on. |
| source_outcome_id | 0..1 | id | — | Outcome that proposed this state, when that is the origin. |
| note | 0..1 | string | — | Short rationale. |
State machine
current/ initial — The state in force. Frozen.superseded— Replaced by a newer current state. Set by the harness.entered_in_error— Withdrawn.
current → entered_in_error. Supersede is a harness cascade, not a caller move.
Frozen: current, superseded, and entered_in_error.
Terminology bindings
| Element | Strength | Values |
|---|---|---|
| scope | required | general | condition |
Invariants
ccs-sta-1— At most one current state for general, and one per condition_code.ccs-sta-2— Declaring a new current state supersedes the previous under the deciding clinician's name.
Operations
| Method | Path | Meaning |
|---|---|---|
| GET | /v1/clinical-states | List clinical state. Filter by patient_id, status, and where the model has them, encounter_id or definition_key. |
| POST | /v1/clinical-states | Create a clinical state. Body is the resource minus harness-owned elements. |
| GET | /v1/clinical-states/{id} | Read one clinical state. |
| PATCH | /v1/clinical-states/{id} | Update elements that are not immutable, frozen, or harness-owned. |
| POST | /v1/clinical-states/{id}/transition | Move status. Body is { to, reason }. A gated move returns 202 and an Approval. |
Example
{ "patient_id": "pat_…", "scope": "condition", "condition_code": "mdd", "state": "moderate" }