Building on the Platform
...
Solutions
Access to Clinical Data
Retrieve Medication Request
4min
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 \<region> founda com/1/organizations/\<org x>/fhir/4/medicationrequest?\<parameters> where \<region> should be defined according to the different founda sandbox testing docid\ ncff15xnu1wglst2wnm p and \<org x> 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 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 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 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 ''{ "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" "\<div xmlns=\\"http //www w3 org/1999/xhtml\\">\<p>\<b>generated narrative with details\</b>\</p>\<p>\<b>id\</b> medrx0311\</p>\<p>\<b>contained\</b> \</p>\<p>\<b>identifier\</b> 12345689 (official)\</p>\<p>\<b>status\</b> active\</p>\<p>\<b>intent\</b> order\</p>\<p>\<b>medication\</b> id med0316; chlorthalidone 50mg tablet (product) \<span>(details {snomed ct code '317935006' = 'chlortalidone 50mg tablet', given as 'chlorthalidone 50mg tablet (product)'})\</span>; tablet dose form (qualifier value) \<span>(details {snomed ct code '385055001' = 'tablet', given as 'tablet dose form (qualifier value)'})\</span>\</p>\<p>\<b>subject\</b> \<a>donald duck\</a>\</p>\<p>\<b>encounter\</b> \<a>encounter who leads to this prescription\</a>\</p>\<p>\<b>authoredon\</b> 15/01/2015\</p>\<p>\<b>requester\</b> \<a>patrick pump\</a>\</p>\<p>\<b>reasonreference\</b> \<a>condition for prescribing this medication\</a>\</p>\<p>\<b>note\</b> chlorthalidone increases urniation so take it in the morning\</p>\<p>\<b>dosageinstruction\</b> \</p>\<h3>dispenserequests\</h3>\<table>\<tr>\<td> \</td>\<td>\<b>validityperiod\</b>\</td>\<td>\<b>numberofrepeatsallowed\</b>\</td>\<td>\<b>quantity\</b>\</td>\<td>\<b>expectedsupplyduration\</b>\</td>\</tr>\<tr>\<td> \</td>\<td>15/01/2015 \> 15/01/2016\</td>\<td>1\</td>\<td>30 tab\<span> (details http //terminology hl7 org/codesystem/v3 orderabledrugform code tab = 'tablet')\</span>\</td>\<td>30 days\<span> (details ucum code d = 'd')\</span>\</td>\</tr>\</table>\<h3>substitutions\</h3>\<table>\<tr>\<td> \</td>\<td>\<b>allowed\[x]\</b>\</td>\<td>\<b>reason\</b>\</td>\</tr>\<tr>\<td> \</td>\<td>true\</td>\<td>continuing therapy \<span>(details {http //terminology hl7 org/codesystem/v3 actreason code 'ct' = 'continuing therapy', given as 'continuing therapy'})\</span>\</td>\</tr>\</table>\</div>" }, "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" } } ] }