--- title: Retrieve Medication Request slug: retrieve-medication-request docTags: createdAt: 2023-10-03T13:39:44.721Z --- Access data on prescribed medications requested for a patient. Retrieve information on medication types, dosage instructions, and prescribing healthcare providers. Useful for understanding a patient's prescribed medications and treatment plans. To access this clinical data you'll need the patient identifier, obtainable through the [Retrieve Patient](docId:8OPknnbMTaZ47Rk5HkDD3) interaction. ### Interaction Retrieving the list of medication requests can be done by sending a **GET** request. The request is sent to the MedicationRequest endpoint: `https://api..founda.com/1/organizations//fhir/4/MedicationRequest?` Where `` should be defined according to the different Founda [regions](docId\:ncFf15xNu1WGlST2wNm-P) and `` should be replaced with the Healthcare Provider's organization ID that you are integrated with. The response contains a Bundle with 0, 1 or N matching MedicationRequests. The full MedicationRequest resource can be retrieved with the identifier of the selected MedicationRequest from the result set. ### Profile Founda adheres to recognized standards (IHE, HL7 FHIR) to ensure compatibility and harmonization among diverse systems. If there is a profile available for an interaction, it is recommended and preferred to follow the prescribed transactions. The Retrieve MedicationRequest interaction with the Founda Platform is based on the [IHE QEDm profile](https://www.ihe.net/uploadedFiles/Documents/PCC/IHE_PCC_Suppl_QEDm.pdf). To indicate that the request and response should comply with PCC-44, the `_profile` parameter should be included to the search set: `.../MedicationRequest?_profile=https://profiles.ihe.net/ITI/QEDm`. ### Parameters In order to comply with the PCC-44 transaction, the interaction should at least support the parameter in the table below. Additional search parameters, as defined in the [FHIR MedicationRequest](http://hl7.org/fhir/medicationrequest.html) resource, can be used as well. | **Parameters combination** | **Type** | **Required** | **Description** | | ---------------------------------------------------- | --------------------- | ------------ | ----------------------------------------------------------------------------------------------------------------------- | | `patient` | `reference` | Yes | The patient to search data for | | `patient` + `_include=MedicationRequest::medication` | `reference` + `token` | | The patient to search data for + the parameter for specifying if medication resource should be included in the response | ### Example API call ::::CodeDrawer{title="Retrieve MedicationRequest for Patient" isResponseExpanded="true" autoGeneratedAnchorSlug="retrieve-medicationrequest-for-patient" legacyHash="dpo_jjfjB3ORt7Ex39eEM"} :::CodeblockTabsExamples ```curl curl --location 'https://api.eu.founda.com/1/health/organizations/org-4c5739ba994d4ce9b5255d3f84a2d367/fhir/4/MedicationRequest?patient=2078&_profile=https%3A%2F%2Fprofiles.ihe.net%2FITI%2FQEDm%2F' \ --header 'Authorization: Bearer ory_at_T_sx5CEqgi37wTaptEkGAV9Ggsg4UCzrzOc4Xe29Sto.jfqRUlKTeevVwUmPD6djKD2lAWDh5vRMfIf0PKpNQsU' \ --data '' ``` ::: :::CodeblockTabsResponses ```javascript { "resourceType": "Bundle", "id": "3d07c676-5cb5-4609-84c0-0d5f2a4c7f74", "meta": { "lastUpdated": "2023-10-17T09:20:32.113+00:00" }, "type": "searchset", "total": 1, "link": [ { "relation": "self", "url": "https://api.eu.founda.com/1/health/organizations/org-4c5739ba994d4ce9b5255d3f84a2d367/fhir/4/MedicationRequest?patient=2078&_profile=https://profiles.ihe.net/ITI/QEDm/" } ], "entry": [ { "fullUrl": "https://api.eu.founda.com/1/health/organizations/org-4c5739ba994d4ce9b5255d3f84a2d367/fhir/4/MedicationRequest/2148", "resource": { "resourceType": "MedicationRequest", "id": "2148", "meta": { "versionId": "1", "lastUpdated": "2023-10-05T14:29:19.183+00:00", "source": "#zyjBmATvTcnbpMOM", "tag": [ { "system": "http://terminology.hl7.org/CodeSystem/v3-ActReason", "code": "HTEST", "display": "test health data" } ] }, "text": { "status": "generated", "div": "

Generated Narrative with Details

id: medrx0311

contained:

identifier: 12345689 (OFFICIAL)

status: active

intent: order

medication: id: med0316; Chlorthalidone 50mg tablet (product) (Details : {SNOMED CT code '317935006' = 'Chlortalidone 50mg tablet', given as 'Chlorthalidone 50mg tablet (product)'}); Tablet dose form (qualifier value) (Details : {SNOMED CT code '385055001' = 'Tablet', given as 'Tablet dose form (qualifier value)'})

subject: Donald Duck

encounter: encounter who leads to this prescription

authoredOn: 15/01/2015

requester: Patrick Pump

reasonReference: condition for prescribing this medication

note: Chlorthalidone increases urniation so take it in the morning

dosageInstruction:

DispenseRequests

-ValidityPeriodNumberOfRepeatsAllowedQuantityExpectedSupplyDuration
*15/01/2015 --> 15/01/2016130 TAB (Details: http://terminology.hl7.org/CodeSystem/v3-orderableDrugForm code TAB = 'Tablet')30 days (Details: UCUM code d = 'd')

Substitutions

-Allowed[x]Reason
*truecontinuing therapy (Details : {http://terminology.hl7.org/CodeSystem/v3-ActReason code 'CT' = 'continuing therapy', given as 'continuing therapy'})
" }, "contained": [ { "resourceType": "Medication", "id": "med0316", "code": { "coding": [ { "system": "http://snomed.info/sct", "code": "317935006", "display": "Chlorthalidone 50mg tablet (product)" } ] }, "form": { "coding": [ { "system": "http://snomed.info/sct", "code": "385055001", "display": "Tablet dose form (qualifier value)" } ] } } ], "identifier": [ { "use": "official", "system": "http://www.bmc.nl/portal/prescriptions", "value": "12345689" } ], "status": "active", "intent": "order", "medicationReference": { "reference": "#med0316" }, "subject": { "reference": "Patient/2078", "display": "Donald Duck" }, "encounter": { "reference": "Encounter/2153", "display": "encounter who leads to this prescription" }, "authoredOn": "2015-01-15", "requester": { "reference": "Practitioner/2079", "display": "Patrick Pump" }, "reasonReference": [ { "reference": "Condition/2136", "display": "condition for prescribing this medication" } ], "note": [ { "text": "Chlorthalidone increases urniation so take it in the morning" } ], "dosageInstruction": [ { "sequence": 1, "text": "One tablet daily", "additionalInstruction": [ { "coding": [ { "system": "http://snomed.info/sct", "code": "311504000", "display": "With or after food" } ] } ], "timing": { "code": { "coding": [ { "system": "http://terminology.hl7.org/CodeSystem/v3-GTSAbbreviation", "code": "QD", "display": "QD" } ] } }, "route": { "coding": [ { "system": "http://snomed.info/sct", "code": "26643006", "display": "Oral Route" } ] }, "method": { "coding": [ { "system": "http://snomed.info/sct", "code": "421521009", "display": "Swallow - dosing instruction imperative (qualifier value)" } ] }, "doseAndRate": [ { "type": { "coding": [ { "system": "http://terminology.hl7.org/CodeSystem/dose-rate-type", "code": "ordered", "display": "Ordered" } ] }, "doseQuantity": { "value": 1, "unit": "TAB", "system": "http://terminology.hl7.org/CodeSystem/v3-orderableDrugForm", "code": "TAB" } } ] } ], "dispenseRequest": { "validityPeriod": { "start": "2015-01-15", "end": "2016-01-15" }, "numberOfRepeatsAllowed": 1, "quantity": { "value": 30, "unit": "TAB", "system": "http://terminology.hl7.org/CodeSystem/v3-orderableDrugForm", "code": "TAB" }, "expectedSupplyDuration": { "value": 30, "unit": "days", "system": "http://unitsofmeasure.org", "code": "d" } }, "substitution": { "allowedBoolean": true, "reason": { "coding": [ { "system": "http://terminology.hl7.org/CodeSystem/v3-ActReason", "code": "CT", "display": "continuing therapy" } ] } } }, "search": { "mode": "match" } } ] } ``` ::: ::::