Get a list of medication orders
get
/MedicationOrder
Retrieves a list of medication orders that meet supplied query parameters.
Note: MedicationOrder.medication may be a reference to a contained medication when the medication cannot be represented by a CodeableConcept because it contains a unique combination of ingredients. Medications in the system always exist in the context of a medication order and cannot be referenced independently.
Authorization Types
This operation supports the following authorization types:
- Provider
- Patient
- System
Request
Query Parameters
-
-timing-boundsPeriod: string
The date and time that falls within the period when the medication should be given to the patient.
- Must be provided with a
ge
prefix to imply the date range for the medication orders search. - The time component is optional.
- This parameter cannot be provided with the
_lastUpdated
parameter.
-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. - May be a list separated by commas.
- Must not be provided with any other parameters.
_id=1234
- This parameter is required if the
-
_lastUpdated: string
An explicit or implied 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 medication orders search. - Example:
_lastUpdated=ge2014-05-19T20:54:02.000Z
- For two
_lastUpdated
occurences: - Must be provided with the
le
andge
prefixes to search for medication orders within the given upper and lower timestamps, respectively. - Example:
_lastUpdated=ge2014-05-19T20:54:02.000Z&_lastUpdated=le2014-05-20T12:00:00.000Z
- It only detects changes that affect the clinical meaning of the order. An example of changes that are not caught by this query are changes that would affect the version, but not the FHIR content.
- The time component is required.
- This parameter cannot be provided with the
-timing-boundsPeriod
parameter.
_lastUpdated=ge2014-05-19T20:54:02.000Z
- For a single
-
patient(required): string
The specific patient to return orders for. This parameter is required if the
_id
parameter is not used.
Example:patient=5678
-
status: string
Header Parameters
-
Accept(required): string
The media type to be requested. See what the resource's operation produces for what is supported.
-
Authorization(required): string
Contains the credentials to authenticate a consumer to the service. This should be the OAuth2 Bearer token.
Response
Supported Media Types
- application/fhir+json
Default Response
Example search by patient.
Example Request:
Example Request:
GET https://fhir-open.cerner.com/dstu2/ec2458f2-1e24-41c8-b71b-0e701af7583d/MedicationOrder?patient=12724067
Example Response:
{
'resourceType': 'Bundle',
'id': 'b4a46440-d23a-4161-9456-1587475fc314',
'type': 'searchset',
'total': 2,
'link': [
{
'relation': 'self',
'url': 'https://fhir-open.cerner.com/dstu2/ec2458f2-1e24-41c8-b71b-0e701af7583d/MedicationOrder?patient=12724067'
}
],
'entry': [
{
'fullUrl': 'https://fhir-open.cerner.com/dstu2/ec2458f2-1e24-41c8-b71b-0e701af7583d/MedicationOrder/309799821',
'resource': {
'resourceType': 'MedicationOrder',
'id': '309799821',
'meta': {
'versionId': '1',
'lastUpdated': '2020-03-20T01:00:37.000Z'
},
'text': {
'status': 'generated',
'div': '<div><p><b>Medication Order</b></p><p><b>Patient Name</b>: SMART, JOE</p><p><b>Medication Name</b>: levoFLOXacin</p><p><b>Dosage Instructions</b>: 728 mg = 145.6 mL, IV Piggyback, Daily</p><p><b>Status</b>: Active</p></div>'
},
'dateWritten': '2020-03-05T11:26:02.000-06:00',
'status': 'active',
'patient': {
'reference': 'Patient/12724067',
'display': 'SMART, JOE'
},
'prescriber': {
'reference': 'Practitioner/4122622',
'display': 'Cerner Test, Physician - Hospitalist Cerner'
},
'encounter': {
'reference': 'Encounter/97953480'
},
'medicationCodeableConcept': {
'coding': [
{
'system': 'http://www.nlm.nih.gov/research/umls/rxnorm',
'code': '82122',
'display': 'Levofloxacin',
'userSelected': false
}
],
'text': 'levoFLOXacin'
},
'dosageInstruction': [
{
'text': '728 mg = 145.6 mL, IV Piggyback, Daily',
'_text': {
'extension': [
{
'url': 'https://fhir-ehr.cerner.com/dstu2/StructureDefinition/patient-friendly-display',
'valueString': 'IV Piggyback every day. Refills: 0.'
}
]
},
'timing': {
'repeat': {
'boundsPeriod': {
'start': '2020-03-05T11:26:00.000-06:00'
}
},
'code': {
'coding': [
{
'system': 'http://hl7.org/fhir/timing-abbreviation',
'code': 'QD',
'display': 'QD',
'userSelected': false
}
],
'text': 'Daily'
}
},
'route': {
'coding': [
{
'system': 'http://ncimeta.nci.nih.gov',
'code': 'C38279',
'display': 'INTRAVENOUS DRIP',
'userSelected': false
},
{
'system': 'http://snomed.info/sct',
'code': '47625008',
'display': 'Intravenous route (qualifier value)',
'userSelected': false
}
],
'text': 'IV Piggyback'
},
'doseQuantity': {
'value': 728.0,
'unit': 'mg',
'system': 'http://unitsofmeasure.org',
'code': 'mg'
}
}
],
'dispenseRequest': {
'validityPeriod': {
'start': '2020-03-05T11:26:02.000-06:00'
}
}
}
},
{
'fullUrl': 'https://fhir-open.cerner.com/dstu2/ec2458f2-1e24-41c8-b71b-0e701af7583d/MedicationOrder/309799757',
'resource': {
'resourceType': 'MedicationOrder',
'id': '309799757',
'meta': {
'versionId': '1',
'lastUpdated': '2020-03-20T01:00:37.000Z'
},
'text': {
'status': 'generated',
'div': '<div><p><b>Medication Order</b></p><p><b>Patient Name</b>: SMART, JOE</p><p><b>Medication Name</b>: vancomycin</p><p><b>Dosage Instructions</b>: 2,275 mg, IV Piggyback, Once</p><p><b>Status</b>: Active</p></div>'
},
'dateWritten': '2020-03-05T11:26:02.000-06:00',
'status': 'active',
'dateEnded': '2020-03-05T11:26:00.000-06:00',
'patient': {
'reference': 'Patient/12724067',
'display': 'SMART, JOE'
},
'prescriber': {
'reference': 'Practitioner/4122622',
'display': 'Cerner Test, Physician - Hospitalist Cerner'
},
'encounter': {
'reference': 'Encounter/97953480'
},
'medicationCodeableConcept': {
'coding': [
{
'system': 'http://www.nlm.nih.gov/research/umls/rxnorm',
'code': '11124',
'display': 'Vancomycin',
'userSelected': false
}
],
'text': 'vancomycin'
},
'dosageInstruction': [
{
'text': '2,275 mg, IV Piggyback, Once',
'_text': {
'extension': [
{
'url': 'https://fhir-ehr.cerner.com/dstu2/StructureDefinition/patient-friendly-display',
'valueString': 'IV Piggyback once. Refills: 0.'
}
]
},
'timing': {
'repeat': {
'boundsPeriod': {
'start': '2020-03-05T11:26:00.000-06:00',
'end': '2020-03-05T11:26:00.000-06:00'
}
},
'code': {
'text': 'Once'
}
},
'route': {
'coding': [
{
'system': 'http://ncimeta.nci.nih.gov',
'code': 'C38279',
'display': 'INTRAVENOUS DRIP',
'userSelected': false
},
{
'system': 'http://snomed.info/sct',
'code': '47625008',
'display': 'Intravenous route (qualifier value)',
'userSelected': false
}
],
'text': 'IV Piggyback'
},
'doseQuantity': {
'value': 2275.0,
'unit': 'mg',
'system': 'http://unitsofmeasure.org',
'code': 'mg'
}
}
],
'dispenseRequest': {
'validityPeriod': {
'start': '2020-03-05T11:26:02.000-06: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.