MedicationRequest is a FHIR Resource that describes an order or request for both supply of the medication and the instructions for administration of the medication to a patient.
Accessing a patient's medications can aid in workflows such as:
- Working with the patient to ensure adherence to the medication protocol
- Understanding a patient’s current medications to prevent drug-to-drug interactions
- Advising the patient switch to generic medications to reduce overall out-of-pocket cost
Many payers make this available in a basic form derived from a patient's claims, but some also provide a more detailed view of the patient's medication requests if they have a more robust provider-payer clinical data exchange, such as quality measures.
The full list of search parameters can be found here. Some of the most important are:
The ID of the patient for whom the medication was requested. We recommend using this search parameter along with the
The status of the medication request.
The code of the medication that was requested. This is typically an NDC or RxNorm code.
While some servers may support a resource-level search without any parameters, not all do. We recommend using the format below with the patient ID via the
$PATIENT_ID wildcard as a search parameter.
This is a sample request using
curl "https://api.flexpa.com/fhir/MedicationRequest?patient=$PATIENT_ID" \
-H "Authorization: Bearer $ACCESS_TOKEN"
This is a sample response from Humana using Flexpa API in test mode
A MedicationRequest response contains many fields. You can get an exhaustive list and explanation of each field here. Some notable fields:
entry - A collection of MedicationRequests (see response type on best practice of checking
meta.lastUpdated - An ISO8601 string representing the last time the bundle was modified
entry[i].resource.status - A string representing the status of the MedicationRequest, including:
completed. Medications currently prescribed have
entry[i].resource.medicationCodeableConcept - A coded representation of the medication that the patient was prescribed. Typically this is an NDC and textual name for the medication.
entry[i].resource.authoredOn - The date when the medication was prescribed to the patient
entry[i].resource.dosageInstruction - Information about how the medication should be taken