If you want to access a patient’s prescribed medications—as documented by a specific organization—you can use this API action to retrieve a list. Typically, you can use this for:
To use this API action, you must know the patient identifier. If you don’t, you must locate the appropriate identifier first. .
With this API action, you can retrieve information like medication type, dose, status, timing, frequency, quantity, and more.
You can use this API action with the Redox FHIR® API.
Your connection's system can return results with their own FHIR® or query-based API.
You can only search and receive medication data from one organization for one patient. If you want a more comprehensive list, you must perform this API action for every organization you’re interested in receiving data from.
The MedicationRequest resource is the most direct option if you only want a list of all current prescribed medications. What this doesn’t contain: any details about how much a patient has taken of what they were prescribed.
The MedicationAdministration resource contains what medications were given and details about how it was administered to a patient during an inpatient stay.
Medications are typically represented in SNOMED or RxNorm codes.
Providers often leave detailed comments in addition to the medication data points. This commentary may provide useful context about how the patient should take the medication or similar instructions.
EHR systems may handle these free-text comments differently, so we recommend working with your connection to understand the location and availability of these comments.
This API action comprises one step.
| Required search parameters | Description |
|---|---|
patient | Include the patient resource.id, which can be returned from a search for a patient with demographics. |
The response contains one or more medications for an individual patient. In FHIR® responses, you can find the total number of included medications in the total array.
curl --location --request POST 'https://api.redoxengine.com/fhir/R4/epic-fhir-sandbox/Development/MedicationRequest/_search' \--header 'Content-Type: application/x-www-form-urlencoded' \--header 'Authorization: Bearer ${API_TOKEN}' \--data-urlencode 'patient: egqBHVfQlt4Bw3XGXoxVxHg3'
{"resourceType": "Bundle","type": "searchset","total": 1,"link": [{"relation": "self","url": "https://fhir.epic.com/interconnect-fhir-oauth/api/FHIR/R4/MedicationRequest?_id=&_include=&_revinclude=&_sort=&_count=&authoredon=&encounter=&intent=&patient=egqBHVfQlt4Bw3XGXoxVxHg3&status="}],"entry": [{"link": [{"relation": "self","url": "https://fhir.epic.com/interconnect-fhir-oauth/api/FHIR/R4/MedicationRequest/eFfQJBYPqEBG4EBImXPBY8XpY4eKbdPGjoBAC33ylHWs3"}],"fullUrl": "https://fhir.epic.com/interconnect-fhir-oauth/api/FHIR/R4/MedicationRequest/eFfQJBYPqEBG4EBImXPBY8XpY4eKbdPGjoBAC33ylHWs3","resource": {"resourceType": "MedicationRequest","id": "eFfQJBYPqEBG4EBImXPBY8XpY4eKbdPGjoBAC33ylHWs3","identifier": [{"use": "usual","system": "urn:oid:1.2.840.114350.1.13.0.1.7.2.798268","value": "1066567"}],"status": "completed","intent": "order","category": [{"coding": [{"system": "http://terminology.hl7.org/CodeSystem/medicationrequest-category","code": "community","display": "Community"}],"text": "Community"}],"medicationReference": {"reference": "Medication/eetjoXy-TbdryRS.SobVHBqoCMs8lmt2inFn0657-Y4snqwFF2gPkel3GYPuh2Ofk3","display": "IBUPROFEN 600 MG PO TABS"},"subject": {"reference": "Patient/egqBHVfQlt4Bw3XGXoxVxHg3","display": "Davis, Elijah John"},"encounter": {"reference": "Encounter/emhwuharfnf8VhCQg97qP7Q3"},"authoredOn": "2019-05-24","requester": {"reference": "Practitioner/eM5CWtq15N0WJeuCet5bJlQ3","display": "Physician Family Medicine, MD"},"recorder": {"reference": "Practitioner/eM5CWtq15N0WJeuCet5bJlQ3","display": "Physician Family Medicine, MD"},"reasonCode": [{"coding": [{"system": "http://snomed.info/sct","code": "23406007","display": "Fracture of upper limb (disorder)"},{"system": "http://hl7.org/fhir/sid/icd-9-cm/diagnosis","code": "818.1","display": "Broken arm, left, open, initial encounter"},{"system": "urn:oid:2.16.840.1.113883.6.90","code": "S42.302B","display": "Broken arm, left, open, initial encounter"}],"text": "Broken arm, left, open, initial encounter"}],"courseOfTherapyType": {"coding": [{"system": "http://terminology.hl7.org/CodeSystem/medicationrequest-course-of-therapy","code": "acute","display": "Short course (acute) therapy"}],"text": "Short course (acute) therapy"},"dosageInstruction": [{"text": "Take 1 tablet (600 mg total) by mouth 4 (four) times a day if needed for mild pain or moderate pain (pain).","patientInstruction": "Take 1 tablet (600 mg total) by mouth 4 (four) times a day if needed for mild pain or moderate pain (pain).","timing": {"repeat": {"boundsPeriod": {"start": "2019-05-24"},"frequency": 4,"period": 1,"periodUnit": "d"},"code": {"text": "4 times daily as needed"}},"asNeededBoolean": true,"route": {"coding": [{"system": "urn:oid:1.2.840.114350.1.13.0.1.7.4.798268.7025","code": "15","display": "Oral"},{"system": "http://snomed.info/sct","code": "260548002","display": "Oral"}],"text": "Oral"},"method": {"coding": [{"system": "http://snomed.info/sct","code": "419652001","display": "Take"}],"text": "Take"},"doseAndRate": [{"type": {"coding": [{"system": "http://epic.com/CodeSystem/dose-rate-type","code": "calculated","display": "calculated"}],"text": "calculated"},"doseQuantity": {"value": 600,"unit": "mg","system": "http://unitsofmeasure.org","code": "mg"}},{"type": {"coding": [{"system": "http://epic.com/CodeSystem/dose-rate-type","code": "admin-amount","display": "admin-amount"}],"text": "admin-amount"},"doseQuantity": {"value": 1,"unit": "tablet","system": "http://unitsofmeasure.org","code": "{tbl}"}},{"type": {"coding": [{"system": "http://epic.com/CodeSystem/dose-rate-type","code": "ordered","display": "ordered"}],"text": "ordered"},"doseQuantity": {"value": 600,"unit": "mg","system": "http://unitsofmeasure.org","code": "mg"}}]}],"dispenseRequest": {"validityPeriod": {"start": "2019-05-24"},"numberOfRepeatsAllowed": 0,"quantity": {"value": 90,"unit": "tablet"},"expectedSupplyDuration": {"value": 23,"unit": "Day","system": "http://unitsofmeasure.org","code": "d"}}},"search": {"mode": "match"}}]}