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
- The prescription order is a Regimen and a CareAction of type medication.
- Stopping a regimen stops its medications. Do not delete the row.
Resource content
Elements this resource adds. It also carries the Instance, including patient_id.
| Name | Card. | Type | Flags | Description |
|---|---|---|---|---|
| code | 1..1 | code | — | Medicine code. |
| display | 0..1 | string | — | Name shown to the team and on a prescription. |
| dose | 0..1 | string | — | Dose text. |
| frequency | 0..1 | string | — | Frequency text. |
| route | 0..1 | string | — | Route. |
| regimen_id | 0..1 | id | — | Regimen that recorded it, when prescribed here. |
| source | 0..1 | string | — | Where the row came from, such as regimen. |
| signed_by | 0..1 | id | — | Copied from the regimen. |
| counter_signed_by | 0..1 | id | — | Copied from the regimen. |
| reported_only | 1..1 | boolean | — | True when the patient reported it and it was not prescribed here. |
| start | 0..1 | dateTime | — | Start. |
| end | 0..1 | dateTime | — | End, when stopped or completed. |
State machine
active/ initial — Currently taken.stopped— Stopped. Frozen.completed— Course finished. Frozen.
active → stopped, completed.
Frozen: stopped and completed.
Invariants
ccs-med-1— A stopped or completed medication cannot be edited. A change is a new row.
Operations
| Method | Path | Meaning |
|---|---|---|
| GET | /v1/medications | List medication. Filter by patient_id, status, and where the model has them, encounter_id or definition_key. |
| POST | /v1/medications | Create 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}/transition | Move 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" }