Get a list of medication administrations
get
/MedicationAdministration
Retrieves a list of medication administrations that meet supplied query parameters.
Authorization Types
This operation supports the following authorization types:
Request
Query Parameters
-
_count: string
The maximum number of results to include on a page.
Example:_count=50
-
_id: string
The logical resource ID.
- 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=12345
- This parameter is required if the
-
effective-time: string
A date range for when the administration happened.
- For a single
effective-time
occurrence: - Must be provided with a
ge
,gt
,le
, orlt
prefix to imply the date range for an administrations search. - The time component is required.
- Example:
effective-time=ge2014-05-19T20:54:02.000Z
- For two
effective-time
occurences: - Must be provided once with the
le
orlt
prefix, and once with thege
orgt
prefix to search for administrations within the given upper and lower timestamps, respectively. - The time component is required for both parameters.
- Example:
effective-time=ge2014-05-19T20:54:02.000Z&effective-time=le2014-05-20T20:54:02.000Z
effective-time=ge2014-05-19T20:54:02.000Z
- For a single
-
patient: string
The specific patient to return medication administrations for. This parameter is required if the
_id
parameter is not used.
Example:patient=1234
-
performer: string
The logical resource ID of the practitioner who administered the medication. May be a list separated by commas.
Example:performer=1245,7659
-
status: string
The status of the medication administration event. May be a list separated by commas.
The supported status values arecompleted
,not-done
, andentered-in-error
.
Example:status=completed,not-done
Header Parameters
-
Authorization(required): string
Contains the credentials to authenticate a consumer to the service. This 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/json+fhir
Default Response
Example search by
Example Request:
patient
.Example Request:
GET https://fhir-open.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/MedicationAdministration?patient=12740087
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/MedicationAdministration?patient=12740087'
},
{
'relation': 'next',
'url': 'https://fhir-open.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/MedicationAdministration?patient=12740087&-pageContext=H4sIAAAAAAAAADWMOw7CMBAF7-IaWTEK_myHgDKpUtAhs95ACm8i49Ag7s4ixOueZjQvtcQbKVD96TyojbxCXDtK-5QnPqx1Hkeha2FAKkwF8pQA77FUTU9RAU1ojf7CS7wi658WH4vGOYMJbuudNVbaxOlYh_yPmp33tnGhbWTvD51Gp0KJAAAA&-pageDirection=NEXT'
}
],
'entry': [
{
"fullUrl": 'https://fhir-open.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/MedicationAdministration/197287785',
'resource': {
'resourceType': 'MedicationAdministration',
'id': '197287785',
'meta': {
'versionId': '197287788',
'lastUpdated': '2020-05-11T21:29:30.000Z'
},
'text': {
'status': 'generated',
'div': '<div xmlns=\'http://www.w3.org/1999/xhtml\'><p><b>Medication Administration</b></p><p><b>Patient</b>: PWDOSEMERX, PWDOSEMERX ONE</p><p><b>Medication</b>: potassium acetate + K-Sol + Dextrose 10% with 0.2% NaCl</p><p><b>Dosage</b>: 250 milliliter (iso1000)</p><p><b>Status</b>: Completed</p><p><b>Effective Time</b>: May 11, 2020 9:27 P.M. UTC</p></div>'
},
'contained': [
{
'resourceType': 'Medication',
'id': '197287785',
'code': {
'text': 'potassium acetate + K-Sol + Dextrose 10% with 0.2% NaCl'
},
'ingredient': [
{
'itemCodeableConcept': {
'coding': [
{
'system': 'http://www.nlm.nih.gov/research/umls/rxnorm',
'code': '237381',
'display': 'Potassium Acetate 2 MEQ/ML Injectable Solution',
'userSelected': false
}
],
'text': 'potassium acetate'
},
'strength': {
'numerator': {
'value': 40,
'unit': 'milliequivalents (chemical)',
'system': 'http://unitsofmeasure.org',
'code': 'meq'
},
'denominator': {
'value': 250,
'unit': 'milliliter (iso1000)',
'system': 'http://unitsofmeasure.org',
'code': 'mL'
}
}
},
{
'itemCodeableConcept': {
'coding': [
{
'system': 'http://www.nlm.nih.gov/research/umls/rxnorm',
'code': '204520',
'display': 'Potassium Chloride 2 MEQ/ML Injectable Solution',
'userSelected': false
}
],
'text': 'K-Sol'
},
'strength': {
'numerator': {
'value': 40,
'unit': 'milliequivalents (chemical)',
'system': 'http://unitsofmeasure.org',
'code': 'meq'
},
'denominator': {
'value': 250,
'unit': 'milliliter (iso1000)',
'system': 'http://unitsofmeasure.org',
'code': 'mL'
}
}
},
{
'itemCodeableConcept': {
'coding': [
{
'system': 'http://www.nlm.nih.gov/research/umls/rxnorm',
'code': '245220',
'display': 'Glucose 100 MG/ML / Sodium Chloride 0.0342 MEQ/ML Injectable Solution',
'userSelected': false
}
],
'text': 'Dextrose 10% with 0.2% NaCl'
},
'strength': {
'numerator': {
'value': 250,
'unit': 'milliliter (iso1000)',
'system': 'http://unitsofmeasure.org',
'code': 'mL'
},
'denominator': {
'value': 250,
'unit': 'milliliter (iso1000)',
'system': 'http://unitsofmeasure.org',
'code': 'mL'
}
}
}
]
}
],
'extension': [
{
'valueQuantity': {
'value': 120.00,
'unit': 'minutes',
'system': 'http://unitsofmeasure.org',
'code': 'min'
},
'url': 'https://fhir-ehr.cerner.com/r4/StructureDefinition/infuse-over-time'
}
],
'status': 'completed',
'medicationReference': {
'reference': '#197287785',
'display': 'potassium acetate + K-Sol + Dextrose 10% with 0.2% NaCl'
},
'subject': {
'reference': 'Patient/12740087',
'display': 'PWDOSEMERX, PWDOSEMERX ONE'
},
'context': {
'reference': 'Encounter/97949818'
},
'effectiveDateTime': '2020-05-11T21:27:00.000Z',
'performer': [
{
'function': {
'coding': [
{
'system': 'http://terminology.hl7.org/CodeSystem/med-admin-perform-function',
'code': 'performer',
'display': 'Performer'
}
],
'text': 'Performer'
},
'actor': {
'reference': 'Practitioner/607928',
'display': 'Cerner Test, RN Cerner'
}
}
],
'request': {
'reference': 'MedicationRequest/311887733'
},
'dosage': {
'site': {
'coding': [
{
'system': 'http://snomed.info/sct',
'code': '66480008',
'display': 'Structure of left forearm (body structure)',
'userSelected': false
}
],
'text': 'Arm, Lower, Left'
},
'route': {
'coding': [
{
'system': 'http://snomed.info/sct',
'code': '47625008',
'display': 'Intravenous route (qualifier value)',
'userSelected': false
}
],
'text': 'IV Piggyback'
},
'dose': {
'value': 250,
'unit': 'milliliter (iso1000)',
'system': 'http://unitsofmeasure.org',
'code': 'mL'
},
'rateQuantity': {
'value': 125.00,
'unit': 'milliliter per hour',
'system': 'http://unitsofmeasure.org',
'code': 'mL/h'
}
}
}
},
{
"fullUrl": 'https://fhir-open.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/MedicationAdministration/197287732',
'resource': {
'resourceType': 'MedicationAdministration',
'id': '197287732',
'meta': {
'versionId': '197287733',
'lastUpdated': '2020-05-04T20:40:29.000Z'
},
'text': {
'status': 'generated',
'div': '<div xmlns=\'http://www.w3.org/1999/xhtml\'><p><b>Medication Administration</b></p><p><b>Patient</b>: PWDOSEMERX, PWDOSEMERX ONE</p><p><b>Medication</b>: amoxicillin</p><p><b>Status</b>: Not Done</p><p><b>Effective Time</b>: May 5, 2020 1:00 P.M. UTC</p></div>'
},
'status': 'not-done',
'statusReason': [
{
'text': 'Not Done: Change in Patient Status'
}
],
'medicationCodeableConcept': {
'coding': [
{
'system': 'http://www.nlm.nih.gov/research/umls/rxnorm',
'code': '723',
'display': 'Amoxicillin',
'userSelected': false
}
],
'text': 'amoxicillin'
},
'subject': {
'reference': 'Patient/12740087',
'display': 'PWDOSEMERX, PWDOSEMERX ONE'
},
'context': {
'reference': 'Encounter/97949818'
},
'effectiveDateTime': '2020-05-05T13:00:00.000Z',
'performer': [
{
'function': {
'coding': [
{
'system': 'http://terminology.hl7.org/CodeSystem/med-admin-perform-function',
'code': 'performer',
'display': 'Performer'
}
],
'text': 'Performer'
},
'actor': {
'reference': 'Practitioner/607928',
'display': 'Cerner Test, RN Cerner'
}
}
],
'request': {
'reference': 'MedicationRequest/311662377'
},
'note': [
{
'authorReference': {
'reference': 'Practitioner/607928'
},
'time': '2020-05-04T20:40:29.000Z',
'text': 'This is a not done comment.\n'
},
{
'text': 'This is an order comment'
}
]
}
}
]
}
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.