MedicationStatement

Work with FHIR R4 4.0.1 MedicationStatement resources.

Choose an operation for this resource:

The diagram summarizes MedicationStatement requests and responses. See Supported FHIR REST Interactions for the shared interaction model.


A FHIR client sends requests to the DDFS R4 MedicationStatement API. Search returns a Bundle; create, read and update return a resource; vread returns one historical version; delete returns HTTP 204 without a body. Custom operations and FHIR-formatted errors can return OperationOutcome.

FHIR R4 definition: https://hl7.org/fhir/R4/medicationstatement.html. See interaction response codes and common error responses.

Interactions and permissions

MedicationStatement capabilitySupport or requirement
Conditional createNot supported.
Conditional updateNot supported.
Transaction bundlesNot supported.

Resource content

For shared validation-error responses, see OperationOutcome errors.

MedicationStatement detailRequirement or behavior
Required contentSupply status, subject, and exactly one of medicationCodeableConcept or medicationReference.
StatusValid R4 status values are active, completed, entered-in-error, intended, stopped, on-hold, unknown, and not-taken.
Patient referencesThe subject references a Patient or Group.
Patient referencesPatient searches recognize external FHIR Patient URLs without requiring Reference.type.
Patient referencesFor opaque external URLs or identifier-only Patient subjects, supply Reference.type=Patient to identify the target type.
Resource ruleDDFS does not retrieve remote resources to determine their type.
ReferencesA medicationReference targets Medication.
Required contentSupply at most one of effectiveDateTime and effectivePeriod.
Token filtersOptional identifiers, reasons, supporting references, notes, dosage, narrative, and extensions are preserved.
Contained resourcesContained Medication and MedicationStatement resources and their fragment IDs are preserved with the enclosing resource, including historical versions.
Contained resourcesLocal references must resolve within the enclosing resource and satisfy the same R4 target-type restrictions as other references.
{
  "resourceType": "MedicationStatement",
  "status": "active",
  "medicationCodeableConcept": {
    "coding": [{"system": "http://www.nlm.nih.gov/research/umls/rxnorm", "code": "860975"}]
  },
  "subject": {"reference": "Patient/{patient-id}"},
  "effectivePeriod": {"start": "2026-01-01", "end": "2026-12-31"}
}