MedicationRequest
Overview
The MedicationRequest resource provides orders for all medications with administration instructions for a patient in both the inpatient and outpatient settings (orders or prescriptions filled by a pharmacy and discharge medication orders). This resource also includes a patient’s historical or documented home medications reported by the patient, significant other, or another provider.
If the medication request represents a prescription the patient takes at home, then the start, stop, and other information may not be a representation of when the medication was taken. For example, the system may not know if the patient ever filled or took the prescribed medication, or when the prescription was filled. Documented historical, past, and home medications are commonly captured when taking the patient’s medical history.
This resource supports the following HL7 FHIR US Core Implementation Guide STU 4.0.0 profiles:
The following fields are returned if valued:
- MedicationRequest ID
- Extensions
- Status
- Status Reason
-
Intent
- Details in Implementation Notes sections for reads and searches.
- Identifier
- Category
- Priority
- Reported Boolean
-
Medication
- medicationCodeableConcept | CodeableConcept
- medicationReference | Reference (Medication)
- Patient
- Encounter
- Authored on Date
- Requester
- Reason Code
- Course of Therapy Type
- Note
- Dosage Instructions
- Dispensing Details
- Substitution
- Prior Prescription
Note: The examples provided here are non-normative and replaying them in the public sandbox is not guaranteed to yield the results shown on the site.
Errors
The common errors and OperationOutcomes may be returned.
Terminology Bindings
MedicationRequest.status |
|
MedicationRequest.statusReason |
|
MedicationRequest.category |
|
MedicationRequest.priority |
|
MedicationRequest.medication[x] |
|
MedicationRequest.reasonCode |
MedicationRequest.dosageInstruction.timing.code |
|
MedicationRequest.dosageInstruction.asNeeded[x] |
|
MedicationRequest.dosageInstruction.site |
|
MedicationRequest.dosageInstruction.route |
|
Contained Medication Bindings
Medication.code |
|
Medication.form |
|
Extensions
- clinical-instruction
- pharmacy-verification-status
- NLLPrescriptionFormat
- NLLRegistrationBasis
- NLLDosePackaging
Custom Extensions
All URLs for custom extensions are defined as https://fhir-ehr.cerner.com/r4/StructureDefinition/{id}
ID | Value[x] Type | Description |
---|---|---|
clinical-instruction |
String | Extension to MedicationRequest.dosageInstruction. Represents instructions for an order that are intended for healthcare providers. |
pharmacy-verification-status |
CodeableConcept | Represents whether a medication request was verified by a pharmacist. Supported values are Does not need pharmacy verification , Needs pharmacy verification , or Rejected by pharmacy . |
Swedish Extensions
All URLs for Swedish extensions are defined as http://electronichealth.se/fhir/StructureDefinition/{id}
ID | Value[x] Type | Description |
---|---|---|
NLLPrescriptionFormat |
Coding | Current prescription format. |
NLLRegistrationBasis |
Coding | Format for prescription registration. |
NLLDosePackaging |
Boolean | Dose dispensed prescription. |
Search
Search for medication requests that meet supplied query parameters.
GET /MedicationRequest?:parameters
Authorization Types
Parameters
Name | Required? | Type | Description |
---|---|---|---|
_id |
Conditionally | token |
The logical resource ID associated with the resource. Example: _id=1234
|
patient |
Conditionally | reference |
The specific patient to return medication requests for. Example: patient=5678
|
status |
No | token |
The status of the medication. May be a list separated by commas. Example: status=active,completed
|
intent |
No | token |
Whether the medication is an authorization or a medication reported by a patient. Example: intent=order,plan
|
-timing-boundsPeriod |
No | token |
The date and time which should fall within the dosageInstruction.timing.repeat.boundsPeriod when the medication should be given to the patient. Example: -timing-boundsPeriod=ge2014-05-19T20:54:02.000Z
|
_lastUpdated |
No | date |
The date and time range within which the most recent clinically relevant update was made to the medication. The time component is required. Example: _lastUpdated=ge2014-05-19T20:54:02.000Z
|
_count |
No | number |
The maximum number of results to include on a page. Example: _count=50
|
_revinclude |
No | token |
The Provenance resource entries to be returned as part of the bundle. Example: _revinclude=Provenance:target
|
Notes
- When searching with the
_id
parameter:- It must not be provided with any other parameters, except with the
_revinclude
parameter as indicated below.
- It must not be provided with any other parameters, except with the
- When searching with the
-timing-boundsPeriod
parameter:- It must be provided with a
ge
prefix to imply the date range for the medications search. - The time component is optional.
- Example:
-timing-boundsPeriod=ge2014-05-19T20:54:02.000Z
- It must be provided with a
- When searching with the
_lastUpdated
parameter:- For a single
_lastUpdated
occurence:- It must be provided with a
le
orge
prefix to imply the date range for the medications search. - Example:
_lastUpdated=ge2014-05-19T20:54:02.000Z
- It must be provided with a
- For two
_lastUpdated
occurences:- It must be provided with the
le
andge
prefixes to search for medications within the given upper and lower timestamps, respectively. - Example:
_lastUpdated=ge2014-05-19T20:54:02.000Z&_lastUpdated=le2014-05-20T12:00:00.000Z
- It must be provided with the
- For a single
- When searching with the
_revinclude
parameter:- It can be provided once with the
Provenance:target
value. Example:_revinclude=Provenance:target
- It can be provided with the
_id
orpatient
parameter. Example:_id=74771957,4732066&_revinclude=Provenance:target
- It can be provided once with the
- When
_revinclude
is provided in a request to the closed endpoint, the OAuth2 token must include the scope corresponding to the Authorization Type, such asuser/Provenance.read
,patient/Provenance.read
orsystem/Provenance.read
.
Headers
Accept: application/fhir+json
Authorization: <OAuth2 Bearer Token>
Example
Request
GET https://fhir-open.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/MedicationRequest?patient=12742400
Response
Status: 200 OK
{
"resourceType": "Bundle",
"id": "b630105a-2ec0-4877-8f8c-3b26b53cacd9",
"type": "searchset",
"link": [
{
"relation": "self",
"url": "https://fhir-open.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/MedicationRequest?patient=1316024"
}
],
"entry": [
{
"fullUrl": "https://fhir-open.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/MedicationRequest/313757847",
"resource": {
"resourceType": "MedicationRequest",
"id": "313757847",
"meta": {
"versionId": "3",
"lastUpdated": "2020-07-21T01:00:49.000Z"
},
"text": {
"status": "generated",
"div": "<div xmlns=\\"http://www.w3.org/1999/xhtml\\"><p><b>Medication Request</b></p>\\\n <p><b>Status</b>: Active</p>\\\n <p><b>Intent</b>: Order</p>\\\n <p><b>Medication</b>: lisinopril-hydroCHLOROthiazide\n (lisinopril-hydroCHLOROthiazide 10 mg-12.5 mg oral tablet)</p>\\\n <p><b>Dosage Instructions</b>: 1 tab, Oral, Daily</p>\\\n <p><b>Patient</b>: PETERS, TIM A</p><p><b>Authored On</b>: Nov 21, 2020 8:59 P.M. UTC</p></div>"
},
"extension": [
{
"valueCoding": {
"system": "http://electronichealth.se/fhir/ValueSet/prescription-format",
"code": "ELECTRONIC",
"display": "Electronic"
},
"url": "http://electronichealth.se/fhir/StructureDefinition/NLLPrescriptionFormat"
},
{
"valueCoding": {
"system": "http://ehalsomyndigheten.se/fhir/ValueSet/registration-basis-codes",
"code": "ELECTRONIC",
"display": "Electronic"
},
"url": "http://electronichealth.se/fhir/StructureDefinition/NLLRegistrationBasis"
},
{
"valueCodeableConcept": {
"text": "Does not need pharmacy verification"
},
"url": "https://fhir-ehr.cerner.com/r4/StructureDefinition/pharmacy-verification-status"
}
],
"status": "active",
"intent": "order",
"category": [
{
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/medicationrequest-category",
"code": "inpatient",
"display": "Inpatient",
"userSelected": false
}
]
}
],
"reportedBoolean": false,
"medicationCodeableConcept": {
"coding": [
{
"system": "http://www.nlm.nih.gov/research/umls/rxnorm",
"code": "830261",
"display": "Hepatitis B Surface Antigen Vaccine 0.04 MG/ML Injectable Suspension",
"userSelected": false
},
{
"system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/synonym",
"code": "19953289",
"display": "hepatitis B adult vaccine dialysis 40 mcg/mL intramuscular suspension",
"userSelected": true
}
],
"text": "hepatitis B adult vaccine (hepatitis B adult vaccine dialysis 40 mcg/mL intramuscular suspension)"
},
"subject": {
"reference": "Patient/12724066",
"display": "SMART, NANCY"
},
"encounter": {
"reference": "Encounter/97953477"
},
"authoredOn": "2020-07-06T15:37:13.000-05:00",
"requester": {
"reference": "Practitioner/2",
"display": "CERNER, CERNER CERNER"
},
"courseOfTherapyType": {
"coding": [
{
"system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/4009",
"code": "2337",
"display": "Physician Stop",
"userSelected": true
},
{
"system": "http://terminology.hl7.org/CodeSystem/medicationrequest-course-of-therapy",
"code": "acute",
"display": "Short course (acute) therapy",
"userSelected": false
}
],
"text": "Physician Stop"
},
"dosageInstruction": [
{
"extension": [
{
"valueString": "40 mcg = 1 mL, IM, Once, First Dose: 12/07/16 16:00:00 CST",
"url": "https://fhir-ehr.cerner.com/r4/StructureDefinition/clinical-instruction"
}
],
"text": "40 mcg = 1 mL, IM, Once",
"patientInstruction": "1 Milliliters Intramuscular (in a muscle) once. Refills: 0.",
"timing": {
"repeat": {
"boundsPeriod": {
"start": "2020-07-06T16:00:00.000-05:00",
"end": "2020-07-06T16:00:00.000-05:00"
}
},
"code": {
"coding": [
{
"system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/4003",
"code": "696531",
"display": "Once",
"userSelected": true
}
],
"text": "Once"
}
},
"route": {
"coding": [
{
"system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/4001",
"code": "318167",
"display": "IM",
"userSelected": true
},
{
"system": "http://snomed.info/sct",
"code": "78421000",
"display": "Intramuscular route (qualifier value)",
"userSelected": false
}
],
"text": "IM"
},
"doseAndRate": [
{
"doseQuantity": {
"value": 1.0,
"unit": "mL",
"system": "http://unitsofmeasure.org",
"code": "mL"
}
}
]
}
],
"dispenseRequest": {
"extension": [
{
"valueBoolean": false,
"url": "http://electronichealth.se/fhir/StructureDefinition/NLLDosePackaging"
}
],
"validityPeriod": {
"start": "2020-07-06T15:37:13.000-05:00"
}
}
}
}
]
}
Example with RevInclude
Authorization Types
Request
GET https://fhir-ehr.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/MedicationRequest?_id=16863377&_revinclude=Provenance:target
Response
Status: 200 OK
{
"resourceType": "Bundle",
"id": "960a7634-8981-437c-bb94-199c767ef1be",
"type": "searchset",
"total": 1,
"link": [
{
"relation": "self",
"url": "https://fhir-ehr.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/MedicationRequest?_id=16863377&_revinclude=Provenance%3Atarget"
}
],
"entry": [
{
"fullUrl": "https://fhir-ehr.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/MedicationRequest/16863377",
"resource": {
"resourceType": "MedicationRequest",
"id": "16863377",
"meta": {
"versionId": "4",
"lastUpdated": "2020-08-08T00:21:25.000Z"
},
"text": {
"status": "generated",
"div": "<div xmlns="http://www.w3.org/1999/xhtml"><p><b>Medication Request</b></p><p><b>Status</b>: Active</p><p><b>Intent</b>: Order</p><p><b>Medication</b>: DOPamine 400 mg [3 mcg/kg/min] + Premix Dextrose 5% in Water 500 mL</p><p><b>Dosage Instructions</b>: 17.55 mL/hr, IV</p><p><b>Patient</b>: ANDERSON, JOHN</p><p><b>Authored On</b>: May 4, 2016 5:25 A.M. CDT</p></div>"
},
"contained": [
{
"resourceType": "Medication",
"id": "21268149",
"code": {
"text": "DOPamine 400 mg [3 mcg/kg/min] + Premix Dextrose 5% in Water 500 mL"
},
"ingredient": [
{
"itemCodeableConcept": {
"coding": [
{
"system": "http://www.nlm.nih.gov/research/umls/rxnorm",
"code": "3628",
"display": "Dopamine",
"userSelected": false
},
{
"system": "https://fhir.cerner.com/eb2384f8-839e-4c6e-8b29-18e71db1a0b1/synonym",
"code": "2756466",
"display": "DOPamine",
"userSelected": true
}
],
"text": "DOPamine"
},
"strength": {
"numerator": {
"value": 400,
"unit": "mg",
"system": "http://unitsofmeasure.org",
"code": "mg"
},
"denominator": {
"value": 500,
"unit": "mL",
"system": "http://unitsofmeasure.org",
"code": "mL"
}
}
},
{
"itemCodeableConcept": {
"coding": [
{
"system": "https://fhir.cerner.com/eb2384f8-839e-4c6e-8b29-18e71db1a0b1/synonym",
"code": "21268149",
"display": "Premix Dextrose 5% in Water",
"userSelected": true
}
],
"text": "Premix Dextrose 5% in Water"
},
"strength": {
"numerator": {
"value": 500,
"unit": "mL",
"system": "http://unitsofmeasure.org",
"code": "mL"
},
"denominator": {
"value": 500,
"unit": "mL",
"system": "http://unitsofmeasure.org",
"code": "mL"
}
}
}
]
}
],
"extension": [
{
"valueCoding": {
"system": "http://electronichealth.se/fhir/ValueSet/prescription-format",
"code": "ELECTRONIC",
"display": "Electronic"
},
"url": "http://electronichealth.se/fhir/StructureDefinition/NLLPrescriptionFormat"
},
{
"valueCoding": {
"system": "http://ehalsomyndigheten.se/fhir/ValueSet/registration-basis-codes",
"code": "ELECTRONIC",
"display": "Electronic"
},
"url": "http://electronichealth.se/fhir/StructureDefinition/NLLRegistrationBasis"
},
{
"valueCodeableConcept": {
"text": "Needs pharmacy verification"
},
"url": "https://fhir-ehr.cerner.com/r4/StructureDefinition/pharmacy-verification-status"
}
],
"status": "active",
"intent": "order",
"category": [
{
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/medicationrequest-category",
"code": "inpatient",
"display": "Inpatient",
"userSelected": false
}
]
}
],
"reportedBoolean": false,
"medicationReference": {
"reference": "#21268149",
"display": "DOPamine 400 mg [3 mcg/kg/min] + Premix Dextrose 5% in Water 500 mL"
},
"subject": {
"reference": "Patient/1295925",
"display": "ANDERSON, JOHN"
},
"encounter": {
"reference": "Encounter/2832456"
},
"authoredOn": "2016-05-04T05:25:50.000-05:00",
"requester": {
"reference": "Practitioner/2927954",
"display": "Arora, Mohit"
},
"dosageInstruction": [
{
"extension": [
{
"valueString": "Total Volume (mL): 500, IV, 17.55 mL/hr, Start Date: 05/03/16 0:27:00 CDT",
"url": "https://fhir-ehr.cerner.com/r4/StructureDefinition/clinical-instruction"
}
],
"text": "17.55 mL/hr, IV",
"patientInstruction": "17.55 Milliliter/hour Intravenous. Refills: 0.",
"timing": {
"repeat": {
"boundsPeriod": {
"start": "2016-05-03T05:27:00.000-05:00"
}
}
},
"route": {
"coding": [
{
"system": "https://fhir.cerner.com/eb2384f8-839e-4c6e-8b29-18e71db1a0b1/codeSet/4001",
"code": "318170",
"display": "IV",
"userSelected": true
},
{
"system": "http://snomed.info/sct",
"code": "47625008",
"display": "Intravenous route (qualifier value)",
"userSelected": false
}
],
"text": "IV"
},
"doseAndRate": [
{
"doseQuantity": {
"value": 500,
"unit": "mL",
"system": "http://unitsofmeasure.org",
"code": "mL"
},
"rateQuantity": {
"value": 17.55,
"unit": "mL/hr",
"system": "http://unitsofmeasure.org",
"code": "mL/h"
}
}
]
}
],
"dispenseRequest": {
"extension": [
{
"valueBoolean": false,
"url": "http://electronichealth.se/fhir/StructureDefinition/NLLDosePackaging"
}
],
"validityPeriod": {
"start": "2016-05-04T05:25:50.000-05:00"
}
}
},
"search": {
"mode": "match"
}
},
{
"fullUrl": "https://fhir-ehr.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/Provenance/med-13343164",
"resource": {
"resourceType": "Provenance",
"id": "med-13343164",
"meta": {
"versionId": "13343164",
"lastUpdated": "2021-05-27T06:14:27-05:00"
},
"text": {
"status": "generated",
"div": "<div xmlns="http://www.w3.org/1999/xhtml"><p><b>Provenance</b></p><p><b>Target</b>:</p><ul><li>MedicationRequest/16863377</li></ul><p><b>Recorded</b>: Oct 25, 2019 9:57 A.M. CDT</p><p><b>Agents</b>:</p><dl><dt>Unknown</dt><dd><b>Agent Type</b>: Transmitter</dd><dd><b>Agent Role</b>: Source</dd></dl><p><b>Entity Source</b>: DocumentReference/17255835</p></div>"
},
"target": [
{
"reference": "MedicationRequest/16863377"
}
],
"recorded": "2019-10-25T09:57:43-05:00",
"agent": [
{
"type": {
"coding": [
{
"system": "http://hl7.org/fhir/us/core/CodeSystem/us-core-provenance-participant-type",
"code": "transmitter"
}
],
"text": "Transmitter"
},
"role": [
{
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/contractsignertypecodes",
"code": "SOURCE"
}
],
"text": "Source"
}
],
"who": {
"reference": "Organization/619848",
"display": "Unknown"
}
}
],
"entity": [
{
"role": "source",
"what": {
"reference": "DocumentReference/17255835"
}
}
]
},
"search": {
"mode": "include"
}
}
]
}
Patient Authorization Request
GET https://fhir-ehr.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/MedicationRequest?patient=12742400
Response
Status: 200 OK
{
"resourceType": "Bundle",
"id": "40d441d8-d53c-4bd6-b20e-d0c1af3244a3",
"type": "searchset",
"link": [
{
"relation": "self",
"url": "https://fhir-ehr.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/MedicationRequest?patient=12724065"
},
{
"relation": "next",
"url": "https://fhir-ehr.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/MedicationRequest?patient=12724065&-pageContext=T3BlblBsYXRmb3JtRmhpckNvbnRleHQ9dHJ1ZSZwYWdlQ29udGV4dD02MDY4MDUwXzYwNjgwNTFfMTI3MjQwNjVfMTI5MjMwOV8xJmNvbmNlcHQ9Y2hhcnRlZA%3D%3D&-pageDirection=NEXT"
}
],
"entry": [
{
"fullUrl": "https://fhir-ehr.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/MedicationRequest/314010287",
"resource": {
"resourceType": "MedicationRequest",
"id": "314010287",
"meta": {
"versionId": "0",
"lastUpdated": "2020-07-14T14:45:37.000Z"
},
"text": {
"status": "generated",
"div": "<div xmlns=\\"http://www.w3.org/1999/xhtml\\"><p><b>Medication Request</b></p>\\\n <p><b>Status</b>: Active</p><p><b>Intent</b>: Order</p>\\\n <p><b>Medication</b>: acetaminophen (acetaminophen 325 mg oral capsule)</p>\\\n <p><b>Dosage Instructions</b>: 650 mg = 2 cap, Oral, every 4 hr,\n PRN: as needed for pain, 90 cap, 0 Refill(s)</p>\\\n <p><b>Patient</b>: SMART, WILMA</p><p><b>Authored On</b>: Jul 14, 2020 2:45 P.M. UTC</p></div>"
},
"extension": [
{
"valueCoding": {
"system": "http://electronichealth.se/fhir/ValueSet/prescription-format",
"code": "ELECTRONIC",
"display": "Electronic"
},
"url": "http://electronichealth.se/fhir/StructureDefinition/NLLPrescriptionFormat"
},
{
"valueCoding": {
"system": "http://ehalsomyndigheten.se/fhir/ValueSet/registration-basis-codes",
"code": "ELECTRONIC",
"display": "Electronic"
},
"url": "http://electronichealth.se/fhir/StructureDefinition/NLLRegistrationBasis"
}
],
"status": "active",
"intent": "order",
"category": [
{
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/medicationrequest-category",
"code": "community",
"display": "Community",
"userSelected": false
}
]
},
{
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/medicationrequest-category",
"code": "discharge",
"display": "Discharge",
"userSelected": false
}
]
}
],
"reportedBoolean": false,
"medicationCodeableConcept": {
"coding": [
{
"system": "http://www.nlm.nih.gov/research/umls/rxnorm",
"code": "198436",
"display": "Acetaminophen 325 MG Oral Capsule"
},
{
"system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/synonym",
"code": "276230589",
"display": "acetaminophen 325 mg oral capsule"
}
],
"text": "acetaminophen (acetaminophen 325 mg oral capsule)"
},
"subject": {
"reference": "Patient/12724065",
"display": "SMART, WILMA"
},
"encounter": {
"reference": "Encounter/97953483"
},
"authoredOn": "2020-07-14T09:45:15.000-05:00",
"requester": {
"reference": "Practitioner/12732044",
"display": "PWMedActionPlan, Physician - Primary Care"
},
"courseOfTherapyType": {
"coding": [
{
"system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/4009",
"code": "2338",
"display": "Soft Stop"
},
{
"system": "http://terminology.hl7.org/CodeSystem/medicationrequest-course-of-therapy",
"code": "continuous",
"display": "Continuous long term therapy"
}
],
"text": "Maintenance"
},
"dosageInstruction": [
{
"text": "650 mg = 2 cap, Oral, every 4 hr, PRN: as needed for pain, 90 cap, 0 Refill(s)",
"patientInstruction": "2 Capsules Oral (given by mouth) every 4 hours as needed as needed for pain.\n Refills: 0.",
"timing": {
"repeat": {
"boundsPeriod": {
"start": "2020-07-14T09:45:00.000-05:00"
}
},
"code": {
"coding": [
{
"system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/4003",
"code": "696547",
"display": "every 4 hr"
},
{
"system": "http://terminology.hl7.org/CodeSystem/v3-GTSAbbreviation",
"code": "Q4H",
"display": "Q4H"
},
{
"system": "http://snomed.info/sct",
"code": "225756002",
"display": "Every four hours (qualifier value)"
}
],
"text": "every 4 hr"
}
},
"asNeededCodeableConcept": {
"text": "as needed for pain"
},
"route": {
"coding": [
{
"system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/4001",
"code": "318185",
"display": "Oral",
"userSelected": true
},
{
"system": "http://snomed.info/sct",
"code": "26643006",
"display": "Oral route (qualifier value)",
"userSelected": false
}
],
"text": "Oral"
},
"doseAndRate": [
{
"doseQuantity": {
"value": 2,
"unit": "cap",
"system": "http://unitsofmeasure.org",
"code": "{Capsule}"
}
}
]
}
],
"dispenseRequest": {
"extension": [
{
"valueBoolean": false,
"url": "http://electronichealth.se/fhir/StructureDefinition/NLLDosePackaging"
}
],
"validityPeriod": {
"start": "2020-07-14T09:45:15.000-05:00"
},
"numberOfRepeatsAllowed": 0,
"quantity": {
"value": 90,
"unit": "cap",
"system": "http://unitsofmeasure.org",
"code": "{Capsule}"
}
},
"substitution": {
"allowedBoolean": true
}
}
}
]
}
Retrieve by ID
List an individual medication request by its ID.
GET /MedicationRequest/:id
Authorization Types
Headers
Accept: application/json+fhir
Authorization: <OAuth2 Bearer Token>
Example
Request
GET https://fhir-open.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/MedicationRequest/56770371
Response
Status: 200 OK
{
"fullUrl": "https://fhir-open.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/MedicationRequest/313757847",
"resource": {
"resourceType": "MedicationRequest",
"id": "313757847",
"meta": {
"versionId": "3",
"lastUpdated": "2020-07-21T01:00:49.000Z"
},
"text": {
"status": "generated",
"div": "<div xmlns=\\"http://www.w3.org/1999/xhtml\\"><p><b>Medication Request</b></p>\\\n <p><b>Status</b>: Active</p>\\\n <p><b>Intent</b>: Order</p>\\\n <p><b>Medication</b>: lisinopril-hydroCHLOROthiazide\n (lisinopril-hydroCHLOROthiazide 10 mg-12.5 mg oral tablet)</p>\\\n <p><b>Dosage Instructions</b>: 1 tab, Oral, Daily</p>\\\n <p><b>Patient</b>: PETERS, TIM A</p><p><b>Authored On</b>: Nov 21, 2020 8:59 P.M. UTC</p></div>"
},
"extension": [
{
"valueCoding": {
"system": "http://electronichealth.se/fhir/ValueSet/prescription-format",
"code": "ELECTRONIC",
"display": "Electronic"
},
"url": "http://electronichealth.se/fhir/StructureDefinition/NLLPrescriptionFormat"
},
{
"valueCoding": {
"system": "http://ehalsomyndigheten.se/fhir/ValueSet/registration-basis-codes",
"code": "ELECTRONIC",
"display": "Electronic"
},
"url": "http://electronichealth.se/fhir/StructureDefinition/NLLRegistrationBasis"
},
{
"valueCodeableConcept": {
"text": "Does not need pharmacy verification"
},
"url": "https://fhir-ehr.cerner.com/r4/StructureDefinition/pharmacy-verification-status"
}
],
"status": "active",
"intent": "order",
"category": [
{
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/medicationrequest-category",
"code": "inpatient",
"display": "Inpatient",
"userSelected": false
}
]
}
],
"reportedBoolean": false,
"medicationCodeableConcept": {
"coding": [
{
"system": "http://www.nlm.nih.gov/research/umls/rxnorm",
"code": "830261",
"display": "Hepatitis B Surface Antigen Vaccine 0.04 MG/ML Injectable Suspension",
"userSelected": false
},
{
"system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/synonym",
"code": "19953289",
"display": "hepatitis B adult vaccine dialysis 40 mcg/mL intramuscular suspension",
"userSelected": true
}
],
"text": "hepatitis B adult vaccine (hepatitis B adult vaccine dialysis 40 mcg/mL intramuscular suspension)"
},
"subject": {
"reference": "Patient/12724066",
"display": "SMART, NANCY"
},
"encounter": {
"reference": "Encounter/97953477"
},
"authoredOn": "2020-07-06T15:37:13.000-05:00",
"requester": {
"reference": "Practitioner/2",
"display": "CERNER, CERNER CERNER"
},
"courseOfTherapyType": {
"coding": [
{
"system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/4009",
"code": "2337",
"display": "Physician Stop",
"userSelected": true
},
{
"system": "http://terminology.hl7.org/CodeSystem/medicationrequest-course-of-therapy",
"code": "acute",
"display": "Short course (acute) therapy",
"userSelected": false
}
],
"text": "Physician Stop"
},
"dosageInstruction": [
{
"extension": [
{
"valueString": "40 mcg = 1 mL, IM, Once, First Dose: 12/07/16 16:00:00 CST",
"url": "https://fhir-ehr.cerner.com/r4/StructureDefinition/clinical-instruction"
}
],
"text": "40 mcg = 1 mL, IM, Once",
"patientInstruction": "1 Milliliters Intramuscular (in a muscle) once. Refills: 0.",
"timing": {
"repeat": {
"boundsPeriod": {
"start": "2020-07-06T16:00:00.000-05:00",
"end": "2020-07-06T16:00:00.000-05:00"
}
},
"code": {
"coding": [
{
"system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/4003",
"code": "696531",
"display": "Once",
"userSelected": true
}
],
"text": "Once"
}
},
"route": {
"coding": [
{
"system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/4001",
"code": "318167",
"display": "IM",
"userSelected": true
},
{
"system": "http://snomed.info/sct",
"code": "78421000",
"display": "Intramuscular route (qualifier value)",
"userSelected": false
}
],
"text": "IM"
},
"doseAndRate": [
{
"doseQuantity": {
"value": 1.0,
"unit": "mL",
"system": "http://unitsofmeasure.org",
"code": "mL"
}
}
]
}
],
"dispenseRequest": {
"extension": [
{
"valueBoolean": false,
"url": "http://electronichealth.se/fhir/StructureDefinition/NLLDosePackaging"
}
],
"validityPeriod": {
"start": "2020-07-06T15:37:13.000-05:00"
}
}
}
}
Patient Authorization Request For Active Status
GET https://fhir-ehr.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/MedicationRequest/314010287
Response
Status: 200 OK
{
"resourceType": "MedicationRequest",
"id": "314010287",
"meta": {
"versionId": "0",
"lastUpdated": "2020-07-14T14:45:37.000Z"
},
"text": {
"status": "generated",
"div": "<div xmlns=\\"http://www.w3.org/1999/xhtml\\"><p><b>Medication Request</b></p>\\\n <p><b>Status</b>: Active</p><p><b>Intent</b>: Order</p>\\\n <p><b>Medication</b>: acetaminophen (acetaminophen 325 mg oral capsule)</p>\\\n <p><b>Dosage Instructions</b>: 650 mg = 2 cap, Oral, every 4 hr,\n PRN: as needed for pain, 90 cap, 0 Refill(s)</p>\\\n <p><b>Patient</b>: SMART, WILMA</p><p><b>Authored On</b>: Jul 14, 2020 2:45 P.M. UTC</p></div>"
},
"extension": [
{
"valueCoding": {
"system": "http://electronichealth.se/fhir/ValueSet/prescription-format",
"code": "ELECTRONIC",
"display": "Electronic"
},
"url": "http://electronichealth.se/fhir/StructureDefinition/NLLPrescriptionFormat"
},
{
"valueCoding": {
"system": "http://ehalsomyndigheten.se/fhir/ValueSet/registration-basis-codes",
"code": "ELECTRONIC",
"display": "Electronic"
},
"url": "http://electronichealth.se/fhir/StructureDefinition/NLLRegistrationBasis"
}
],
"status": "active",
"intent": "order",
"category": [
{
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/medicationrequest-category",
"code": "community",
"display": "Community",
"userSelected": false
}
]
},
{
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/medicationrequest-category",
"code": "discharge",
"display": "Discharge",
"userSelected": false
}
]
}
],
"reportedBoolean": false,
"medicationCodeableConcept": {
"coding": [
{
"system": "http://www.nlm.nih.gov/research/umls/rxnorm",
"code": "198436",
"display": "Acetaminophen 325 MG Oral Capsule"
},
{
"system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/synonym",
"code": "276230589",
"display": "acetaminophen 325 mg oral capsule"
}
],
"text": "acetaminophen (acetaminophen 325 mg oral capsule)"
},
"subject": {
"reference": "Patient/12724065",
"display": "SMART, WILMA"
},
"encounter": {
"reference": "Encounter/97953483"
},
"authoredOn": "2020-07-14T09:45:15.000-05:00",
"requester": {
"reference": "Practitioner/12732044",
"display": "PWMedActionPlan, Physician - Primary Care"
},
"courseOfTherapyType": {
"coding": [
{
"system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/4009",
"code": "2338",
"display": "Soft Stop"
},
{
"system": "http://terminology.hl7.org/CodeSystem/medicationrequest-course-of-therapy",
"code": "continuous",
"display": "Continuous long term therapy"
}
],
"text": "Maintenance"
},
"dosageInstruction": [
{
"text": "650 mg = 2 cap, Oral, every 4 hr, PRN: as needed for pain, 90 cap, 0 Refill(s)",
"patientInstruction": "2 Capsules Oral (given by mouth) every 4 hours as needed as needed for pain.\n Refills: 0.",
"timing": {
"repeat": {
"boundsPeriod": {
"start": "2020-07-14T09:45:00.000-05:00"
}
},
"code": {
"coding": [
{
"system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/4003",
"code": "696547",
"display": "every 4 hr"
},
{
"system": "http://terminology.hl7.org/CodeSystem/v3-GTSAbbreviation",
"code": "Q4H",
"display": "Q4H"
},
{
"system": "http://snomed.info/sct",
"code": "225756002",
"display": "Every four hours (qualifier value)"
}
],
"text": "every 4 hr"
}
},
"asNeededCodeableConcept": {
"text": "as needed for pain"
},
"route": {
"coding": [
{
"system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/4001",
"code": "318185",
"display": "Oral",
"userSelected": true
},
{
"system": "http://snomed.info/sct",
"code": "26643006",
"display": "Oral route (qualifier value)",
"userSelected": false
}
],
"text": "Oral"
},
"doseAndRate": [
{
"doseQuantity": {
"value": 2,
"unit": "cap",
"system": "http://unitsofmeasure.org",
"code": "{Capsule}"
}
}
]
}
],
"dispenseRequest": {
"extension": [
{
"valueBoolean": false,
"url": "http://electronichealth.se/fhir/StructureDefinition/NLLDosePackaging"
}
],
"validityPeriod": {
"start": "2020-07-14T09:45:15.000-05:00"
},
"numberOfRepeatsAllowed": 0,
"quantity": {
"value": 90,
"unit": "cap",
"system": "http://unitsofmeasure.org",
"code": "{Capsule}"
}
},
"substitution": {
"allowedBoolean": true
}
}
Patient Authorization Request For Entered in Error Status
GET https://fhir-ehr.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/MedicationRequest/261542609
Response
Status: 200 OK
{
"resourceType": "MedicationRequest",
"id": "261542609",
"meta": {
"versionId": "4",
"lastUpdated": "2020-12-09T05:29:49.000Z"
},
"text": {
"status": "generated",
"div": "<div xmlns=\\"http://www.w3.org/1999/xhtml\\"><p><b>Medication Request</b></p>\\\n <p><b>Status</b>: Entered in Error</p><p><b>Intent</b>: Order</p>/\n <p><b>Medication</b>: Error</p><p><b>Patient</b>: MARSTON, JACK</p></div>"
},
"extension": [
{
"valueCoding": {
"system": "http://electronichealth.se/fhir/ValueSet/prescription-format",
"code": "ELECTRONIC",
"display": "Electronic"
},
"url": "http://electronichealth.se/fhir/StructureDefinition/NLLPrescriptionFormat"
},
{
"valueCoding": {
"system": "http://ehalsomyndigheten.se/fhir/ValueSet/registration-basis-codes",
"code": "ELECTRONIC",
"display": "Electronic"
},
"url": "http://electronichealth.se/fhir/StructureDefinition/NLLRegistrationBasis"
}
],
"status": "entered-in-error",
"intent": "order",
"medicationCodeableConcept": {
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/data-absent-reason",
"code": "error",
"display": "Error"
}
],
"text": "Error"
},
"subject": {
"reference": "Patient/166045489",
"display": "MARSTON, JACK"
}
}
Create
Create an individual medication request.
POST /MedicationRequest
Notes
- Only the body fields mentioned below are supported. Unsupported fields are ignored.
Authorization Types
Headers
Authorization: <OAuth2 Bearer Token>
Content-Type: application/fhir+json
Body Fields
Name | Required | Type | |
---|---|---|---|
resourceType
|
Yes |
string |
|
|
|||
status
|
Yes |
code |
|
|
|||
intent
|
Yes |
code |
|
|
|||
doNotPerform
|
No |
boolean |
|
|
|||
reported[x]
|
Yes |
boolean |
|
|
|||
medication[x]
|
Yes |
CodeableConcept |
|
|
|||
subject
|
Yes |
Reference (Patient |Group ) |
|
|
|||
encounter
|
No |
Reference (Encounter ) |
|
|
|||
note
|
No |
Annotation |
|
|
|||
dosageInstruction
|
No |
Dosage |
|
|
|||
dosageInstruction.text
|
No |
string |
|
|
|||
dosageInstruction.additionalInstruction
|
No |
string |
|
|
|||
dosageInstruction.timing
|
No |
Timing |
|
|
|||
dosageInstruction.timing.repeat
|
No |
Element |
|
|
|||
dosageInstruction.timing.repeat.bounds[x]
|
No |
Period |
|
|
|||
dosageInstruction.timing.repeat.count
|
No |
positiveInt |
|
|
|||
dosageInstruction.timing.repeat.duration
|
No |
decimal |
|
|
|||
dosageInstruction.timing.repeat.durationUnit
|
No |
code |
|
|
|||
dosageInstruction.timing.code
|
No |
CodeableConcept |
|
|
|||
dosageInstruction.asNeeded[x]
|
No |
boolean | CodeableConcept |
|
|
|||
dosageInstruction.site
|
No |
CodeableConcept |
|
|
|||
dosageInstruction.route
|
No |
CodeableConcept |
|
|
|||
dosageInstruction.doseAndRate
|
No |
Element |
|
|
|||
dosageInstruction.doseAndRate.dose[x]
|
No |
SimpleQuantity |
|
|
|||
dispenseRequest
|
No |
BackboneElement |
|
|
|||
dispenseRequest.numberOfRepeatsAllowed
|
No |
unsignedInt |
|
|
|||
dispenseRequest.quantity
|
No |
SimpleQuantity |
|
|
|||
substitution
|
No |
BackboneElement |
|
|
|||
substitution.allowed[x]
|
No |
boolean |
|
|
Example
Request
POST https://fhir-ehr-code.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/MedicationRequest
Body
{
"resourceType": "MedicationRequest",
"status": "active",
"intent": "order",
"doNotPerform": false,
"reportedBoolean": true,
"medicationCodeableConcept": {
"coding": [
{
"system": "http://www.nlm.nih.gov/research/umls/rxnorm",
"code": "352362"
}
],
"text": "Acetaminophen"
},
"subject": {
"reference": "Patient/12742400"
},
"encounter": {
"reference": "Encounter/97953530"
},
"note": [
{
"authorString": "Leslie Knope",
"time": "2020-03-03T20:07:53Z",
"text": "Patient has had medication in past."
}
],
"dosageInstruction": [
{
"text": "5 mL, Oral, Daily.",
"additionalInstruction": [
{
"text": "Take with food."
}
],
"timing": {
"repeat": {
"boundsPeriod": {
"start": "2020-02-25T23:19:10Z",
"end": "2021-02-27T23:19:10Z"
},
"count": 1,
"duration": 1.0,
"durationUnit": "d"
},
"code": {
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/v3-GTSAbbreviation",
"code": "BID"
}
]
}
},
"asNeededBoolean": true,
"site": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "368208006"
}
]
},
"route": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "41974700"
}
]
},
"doseAndRate": [
{
"doseQuantity": {
"value": 23.0,
"unit": "tabs",
"system": "http://unitsofmeasure.org",
"code": "tbl"
}
}
]
}
],
"dispenseRequest": {
"numberOfRepeatsAllowed": 5,
"quantity": {
"value": 10.0,
"system": "http://unitsofmeasure.org",
"code": "tbl"
}
},
"substitution": {
"allowedBoolean": true
}
}
Response
Status: 201 Created
Cache-Control: no-cache Content-Length: 0 Content-Type: application/fhir+json Date: Wed, 27 Mar 2019 15:59:33 GMT Etag: W/"0" Last-Modified: Wed, 27 Mar 2019 15:59:30 GMT Location: https://fhir-ehr-code.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/MedicationRequest/4595905 Vary: Origin X-Request-Id: 11111111-1111-1111-1111-111111111111 opc-request-id: /11111111111111111111111111111111/11111111111111111111111111111111
Patch
Patch an existing medication request.
PATCH /MedicationRequest/:id
Notes
- This implementation follows the JSON PATCH specification.
- Only operations on the paths listed below are supported.
Authorization Types
Headers
Authorization: <OAuth2 Bearer Token>
Accept: application/fhir+json
Content-Type: application/json-patch+json
If-Match: W/"<Current version of the MedicationRequest resource>"
Patch Operations
Path | Operation | Value Type | |
---|---|---|---|
/status
|
replace |
code |
|
|
Example
Request
PATCH https://fhir-ehr.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/MedicationRequest/1621910
Body
[
{
"op": "replace",
"path": "/status",
"value": "stopped"
}
]
Response
Status: 200 OK
Cache-Control: no-cache Content-Length: 0 Content-Type: text/html Date: Tue, 26 Mar 2019 15:42:29 GMT Etag: W/"10" Last-Modified: Tue, 26 Mar 2019 15:42:27 GMT Vary: Origin X-Request-Id: 11111111-1111-1111-1111-111111111111 opc-request-id: /11111111111111111111111111111111/11111111111111111111111111111111
The ETag
response header indicates the current If-Match
version to use on subsequent updates.