Building on the Platform
...
Solutions
Access to Clinical Data
Retrieve Medication Statement
4min
retrieve a patient's medication history, including current and past medications access details on medication names, dosage, frequency, and adherence ideal for tracking a patient's medication adherence and ensuring safe prescribing practices 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 statements can be done by sending a get request the request is sent to the medicationstatement endpoint https //api \<region> founda com/1/organizations/\<org x>/fhir/4/medicationstatement?\<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 medicationstatements the full medicationstatement resource can be retrieved with the identifier of the selected medicationstatement 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 medicationstatement 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 /medicationstatement? 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 medicationstatement resource, can be used as well parameters combination type required description patient reference yes the patient to search data for patient + include=medicationstatement 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/medicationstatement?patient=2078& profile=https%3a%2f%2fprofiles ihe net%2fiti%2fqedm%2f' \\ \ header 'authorization bearer ory at t sx5ceqgi37wtaptekgav9ggsg4uczrzoc4xe29sto jfqrulkteevvwumpd6djkd2lawdh5vrmfif0pkpnqsu' \\ \ data ''{ "resourcetype" "bundle", "id" "0b51337e 9720 4b19 9e8b 2c8445b5dd1f", "meta" { "lastupdated" "2023 10 17t09 21 21 791+00 00" }, "type" "searchset", "total" 1, "link" \[ { "relation" "self", "url" "https //api eu founda com/1/health/organizations/org 4c5739ba994d4ce9b5255d3f84a2d367/fhir/4/medicationstatement?patient=2078& profile=https //profiles ihe net/iti/qedm/" } ], "entry" \[ { "fullurl" "https //api eu founda com/1/health/organizations/org 4c5739ba994d4ce9b5255d3f84a2d367/fhir/4/medicationstatement/2170", "resource" { "resourcetype" "medicationstatement", "id" "2170", "meta" { "versionid" "1", "lastupdated" "2023 10 05t14 29 20 398+00 00", "source" "#x5kk1iiwvyyib9fs", "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> example001\</p>\<p>\<b>contained\</b> \</p>\<p>\<b>identifier\</b> 12345689 (official)\</p>\<p>\<b>status\</b> active\</p>\<p>\<b>category\</b> inpatient \<span>(details {http //terminology hl7 org/codesystem/medication statement category code 'inpatient' = 'inpatient', given as 'inpatient'})\</span>\</p>\<p>\<b>medication\</b> id med0309; tylenol pm \<span>(details {http //hl7 org/fhir/sid/ndc code '50580 506 02' = 'n/a', given as 'tylenol pm'})\</span>; film coated tablet (qualifier value) \<span>(details {snomed ct code '385057009' = 'film coated tablet', given as 'film coated tablet (qualifier value)'})\</span>\</p>\<p>\<b>subject\</b> \<a>donald duck\</a>\</p>\<p>\<b>effective\</b> 23/01/2015\</p>\<p>\<b>dateasserted\</b> 22/02/2015\</p>\<p>\<b>informationsource\</b> \<a>donald duck\</a>\</p>\<p>\<b>derivedfrom\</b> \<a>medicationrequest/medrx002\</a>\</p>\<p>\<b>reasoncode\</b> restless legs \<span>(details {snomed ct code '32914008' = 'restless legs', given as 'restless legs'})\</span>\</p>\<p>\<b>note\</b> patient indicates they miss the occasional dose\</p>\<p>\<b>dosage\</b> \</p>\</div>" }, "contained" \[ { "resourcetype" "medication", "id" "med0309", "code" { "coding" \[ { "system" "http //hl7 org/fhir/sid/ndc", "code" "50580 506 02", "display" "tylenol pm" } ] }, "form" { "coding" \[ { "system" "http //snomed info/sct", "code" "385057009", "display" "film coated tablet (qualifier value)" } ] }, "ingredient" \[ { "itemcodeableconcept" { "coding" \[ { "system" "http //www nlm nih gov/research/umls/rxnorm", "code" "315266", "display" "acetaminophen 500 mg" } ] }, "strength" { "numerator" { "value" 500, "system" "http //unitsofmeasure org", "code" "mg" }, "denominator" { "value" 1, "system" "http //terminology hl7 org/codesystem/v3 orderabledrugform", "code" "tab" } } }, { "itemcodeableconcept" { "coding" \[ { "system" "http //www nlm nih gov/research/umls/rxnorm", "code" "901813", "display" "diphenhydramine hydrochloride 25 mg" } ] }, "strength" { "numerator" { "value" 25, "system" "http //unitsofmeasure org", "code" "mg" }, "denominator" { "value" 1, "system" "http //terminology hl7 org/codesystem/v3 orderabledrugform", "code" "tab" } } } ], "batch" { "lotnumber" "9494788", "expirationdate" "2017 05 22" } } ], "identifier" \[ { "use" "official", "system" "http //www bmc nl/portal/medstatements", "value" "12345689" } ], "status" "active", "category" { "coding" \[ { "system" "http //terminology hl7 org/codesystem/medication statement category", "code" "inpatient", "display" "inpatient" } ] }, "medicationreference" { "reference" "#med0309" }, "subject" { "reference" "patient/2078", "display" "donald duck" }, "effectivedatetime" "2015 01 23", "dateasserted" "2015 02 22", "informationsource" { "reference" "patient/2078", "display" "donald duck" }, "derivedfrom" \[ { "reference" "medicationrequest/2148" } ], "reasoncode" \[ { "coding" \[ { "system" "http //snomed info/sct", "code" "32914008", "display" "restless legs" } ] } ], "note" \[ { "text" "patient indicates they miss the occasional dose" } ], "dosage" \[ { "sequence" 1, "text" "1 2 tablets once daily at bedtime as needed for restless legs", "additionalinstruction" \[ { "text" "taking at bedtime" } ], "timing" { "repeat" { "frequency" 1, "period" 1, "periodunit" "d" } }, "asneededcodeableconcept" { "coding" \[ { "system" "http //snomed info/sct", "code" "32914008", "display" "restless legs" } ] }, "route" { "coding" \[ { "system" "http //snomed info/sct", "code" "26643006", "display" "oral route" } ] }, "doseandrate" \[ { "type" { "coding" \[ { "system" "http //terminology hl7 org/codesystem/dose rate type", "code" "ordered", "display" "ordered" } ] }, "doserange" { "low" { "value" 1, "unit" "tab", "system" "http //terminology hl7 org/codesystem/v3 orderabledrugform", "code" "tab" }, "high" { "value" 2, "unit" "tab", "system" "http //terminology hl7 org/codesystem/v3 orderabledrugform", "code" "tab" } } } ] } ] }, "search" { "mode" "match" } } ] }