Get a list of medication requests
get
/MedicationRequest
Retrieves a list of medication requests that meet supplied query parameters.
Authorization Types
This operation supports the following authorization types:
Request
Query Parameters
-
-timing-boundsPeriod: string
The date and time that should fall within the
dosageInstruction.timing.repeat.boundsPeriod
when the medication should be given to the patient.- Must be provided with a
ge
prefix to imply the date range for the medications search. - The time component is optional.
-timing-boundsPeriod=ge2014-05-19T20:54:02.000Z
- Must be provided with a
-
_count: number
The maximum number of results to include on a page.
Example:_count=50
-
_id(required): string
The logical resource ID associated with the resource.
- This parameter is required if the
patient
parameter is not used. - Must not be provided with any other parameters, except with the
_revinclude
parameter as indicated below.
_id=1234
- This parameter is required if the
-
_lastUpdated: string
The date and time range within which the most recent clinically relevant update was made to the medication.
- For a single
_lastUpdated
occurence: - 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
- For two
_lastUpdated
occurences: - 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
- The time component is required.
_lastUpdated=ge2014-05-19T20:54:02.000Z
- For a single
-
_revinclude: string
The Provenance resource entries to be returned as part of the bundle.
- May be provided once with the
Provenance:target
value. Example:_revinclude=Provenance:target
. - May be provided with the
_id
orpatient
parameter. Example:_id=74771957,4732066&_revinclude=Provenance:target
. - When
_revinclude
is provided in a request to the closed endpoint, the OAuth2 token must include the scope corresponding with the authorization type, such asuser/Provenance.read
,patient/Provenance.read
, orsystem/Provenance.read
.
_revinclude=Provenance:target
- May be provided once with the
-
intent: string
Whether the medication is an authorization or a medication reported by a patient.
Example:intent=order,plan
-
patient(required): string
The specific patient to return medication requests for. This parameter is required if the
_id
parameter is not used.
Example:patient=5678
-
status: string
Header Parameters
-
Authorization(required): string
Contains the credentials to authenticate a consumer to the service. The credentials should be the OAuth2 Bearer Token.
-
accept(required): string
The media type to be requested. See what the resource's operation produces for what is supported.
Response
Supported Media Types
- application/fhir+json
Default Response
Example search by patient.
Example Request:
Example Request:
GET https://fhir-open.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/MedicationRequest?patient=12742400
Example Response:
{
'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><p><b>Status</b>: Active</p><p><b>Intent</b>: Order</p><p><b>Medication</b>: lisinopril-hydroCHLOROthiazide(lisinopril-hydroCHLOROthiazide 10 mg-12.5 mg oral tablet)</p><p><b>Dosage Instructions</b>: 1 tab, Oral, Daily</p><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'
}
}
}
}
]
}
Headers
-
X-Request-Id: string
Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, provide the
X-Request-Id
, if present. -
opc-request-id: string
Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, provide the
opc-Request-Id
, if present.
x-with-_revinclude Response
Example search while using the
Example Request:
_revinclude
parameter.Example Request:
GET https://fhir-ehr.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/MedicationRequest?_id=16863377&_revinclude=Provenance:target
Example Response:
{
"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'
}
}
]
}
Headers
-
X-Request-Id: string
Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, provide the
X-Request-Id
, if present. -
opc-request-id: string
Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, provide the
opc-Request-Id
, if present.
x-with-patient-auth Response
Example search using patient authorization.
Example Request:
Example Request:
GET https://fhir-ehr.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/MedicationRequest?patient=12742400
Example Response:
{
'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><p><b>Status</b>: Active</p><p><b>Intent</b>: Order</p><p><b>Medication</b>: acetaminophen (acetaminophen 325 mg oral capsule)</p><p><b>Dosage Instructions</b>: 650 mg = 2 cap, Oral, every 4 hr,PRN: as needed for pain, 90 cap, 0 Refill(s)</p><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.
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
}
}
}
]
}
Headers
-
X-Request-Id: string
Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, provide the
X-Request-Id
, if present. -
opc-request-id: string
Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, provide the
opc-Request-Id
, if present.