Clinical Intelligence StandardsVersion 0.2

Functional standard / How they are / PatientInstance

Medication

A medicine the patient is taking, prescribed here or reported.

Kind
medication
Collection
/v1/medications
Initial state
active
Classification
Clinical

Scope and usage

The medication list. A prescribed drug is usually created by a Regimen, not typed as a one-off unless that is the intent.

Boundaries and relationships

Resource content

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

NameCard.TypeFlagsDescription
code1..1code—Medicine code.
display0..1string—Name shown to the team and on a prescription.
dose0..1string—Dose text.
frequency0..1string—Frequency text.
route0..1string—Route.
regimen_id0..1id—Regimen that recorded it, when prescribed here.
source0..1string—Where the row came from, such as regimen.
signed_by0..1id—Copied from the regimen.
counter_signed_by0..1id—Copied from the regimen.
reported_only1..1boolean—True when the patient reported it and it was not prescribed here.
start0..1dateTime—Start.
end0..1dateTime—End, when stopped or completed.

State machine

active → stopped, completed.

Frozen: stopped and completed.

Invariants

Operations

MethodPathMeaning
GET/v1/medicationsList medication. Filter by patient_id, status, and where the model has them, encounter_id or definition_key.
POST/v1/medicationsCreate a medication. Body is the resource minus harness-owned elements.
GET/v1/medications/{id}Read one medication.
PATCH/v1/medications/{id}Update elements that are not immutable, frozen, or harness-owned.
POST/v1/medications/{id}/transitionMove status. Body is { to, reason }. A gated move returns 202 and an Approval.
DELETE/v1/medications/{id}?reason=Soft-delete. Reason is required. Refused when the resource is not deletable or is frozen.

Example

{ "patient_id": "pat_…", "code": "sertraline", "display": "Sertraline", "dose": "50 mg", "frequency": "once daily" }