This page is part of the Retrieval of Real World Data for Clinical Research (v1.0.0: STU1) based on FHIR R4. This is the current published version. For a full list of available versions, see the Directory of published versions
Getting access to the EHR to be able to retrieve patient records is accomplished by following the requirements of International Patient Access. This guide provides additional details on the needed queries and the relevant data elements that are important for supporting clinical research.
To receive medication summary information, a requesting system will have to query the four different Medication workflow resources to find all information about a patient’s medications.
Resource Type | Query |
---|---|
MedicationRequest | [base]/MedicationRequest?patient=Patient/[patient id]&authoredon=ge[history date] |
MedicationDispense | [base]/MedicationDispense?patient=Patient/[patient id]&whenhandedover=ge[history date] |
MedicationAdministration | [base]/MedicationAdministration?patient=Patient/[patient id]&effective-time=ge[history date] |
MedicationStatement | [base]/MedicationStatement/patient=Patient/[patient id]&effective=ge[history date] |
The IPA MedicationRequest and IPA MedicationStatement profiles along with the IPA Medication profile provide the necessary information that are important to RWD. This guide defines a profile on MedicationDispense and MedicationAdministration because those resources are important to get a complete picture of the medications that a patient is taking. See the Medications section of this guide for more information on determining a patient’s medications.
To receive the problem list, the following query for conditions should be made:
[base]/Condition?patient=Patient/[patient id]&recorded-date=ge[history date]
The IPA Condition and IPA Problem List Item profiles provide the necessary information for RWD.
To receive procedures for a patient, the following query for procedures should be made:
[base]/Procedure?patient=Patient/[patient id]&date=ge[history date]
This guide defines a Procedure profile since the IPA guide does not.
To receive observation results for a patient, the following query for observations should be made:
[base]/Observation?patient=Patient/[patient id]&date=ge[history date]
This guide defines a Laboratory Results profile that adds component observations to the base IPA Observation profile.
To receive patient visits for a patient, the following query for encounters should be made:
[base]/Encounter?patient=Patient/[patient id]&date=ge[history date]
This guide defines an Encounter profile since the IPA guide does not.