The EV Web Access API meets the Meaningful Use 3 Application Access Requirements. This section shows the API queries that are used to fulfill the following Application Access Workflows.
https://greathospital.com:8100/sites/123/Patient?identifier=http://hl7.org/fhir/v2/0203|MRN-QD97G59
Search for patient by first name, last name, and date of birth:
https://greathospital.com:8100/sites/123/Patient?given=Jay&family=Bishop&birthdate=1956-02-21
The id for the specific patient instance is encoded within the response. See the id highlighted in yellow below.
{
"resourceType": "Bundle",
"type": "searchset",
"total": 1,
"link": [
{
"relation": "self",
"url": "https://greathospital.com:8100/sites/123/Patient?family=BISHOP"
}
],
"entry": [
{
"fullUrl": "https://greathospital.com:8100/sites/123/Patient/1",
"resource": {
"resourceType": "Patient",
"id": "1",
"text": {
"status": "generated",
"div": "<div xmlns=\"http://www.w3.org/1999/xhtml\"><p><b>Patient</b></p><p><b>Name</b>: BISHOP, Jay</p><p><b>Gender</b>: Male</p> <p><b>BirthDate</b>:1956-02-21</p><p><b>Identifiers</b>:</p><p><b>Medical record number</b>: MRN-6WP64S3</p> <p><b>Communication:</b></p><p><b>Primary Language</b>: Burmese</p> <p><b>General Practitioners:</b></p></div>"
},
"extension": [
{
"url": "http://hl7.org/fhir/StructureDefinition/us-core-race",
"extension": [
{
"url": "ombCategory",
"valueCoding": {
"system": "http://hl7.org/fhir/v3/Race",
"code": "1516-4",
"display": "Zuni"
}
},
{
"url": "ombCategory",
"valueCoding": {
"system": "http://hl7.org/fhir/v3/Race",
"code": "2106-3",
"display": "White"
}
}
]
},
{
"url": "http://hl7.org/fhir/StructureDefinition/us-core-ethnicity",
"extension": [
{
"url": "ombCategory",
"valueCoding": {
"system": "urn:oid:2.16.840.1.113883.6.238",
"code": "2186-5",
"display": "Not Hispanic or Latino"
}
}
]
}
],
"identifier": [
{
"use": "usual",
"type": {
"coding": [
{
"system": "http://hl7.org/fhir/v2/0203",
"code": "MR"
}
],
"text": "Medical record number"
},
"system": "http://hl7.org/fhir/v2/0203",
"value": "MRN-6WP64S3"
}
],
"name": [
{
"text": "BISHOP, Jay",
"family": "BISHOP",
"given": [
"Jay"
]
}
],
"gender": "male",
"birthDate": "1956-02-21",
"communication": [
{
"language": {
"text": "Burmese"
},
"preferred": true
}
]
},
"search": {
"mode": "match"
}
}
]
}
After retrieving the patient id from the Patient Selection Request it can be used to query the clinical data for that patient. In the below queries we will use a patient id of 1.
Search for patient by MRN=MRN-QD97G59: Retrieve the patient demographics, including the race and ethnicity.https://greathospital.com:8100/sites/123/Patient/1
Retrieve the patient visit encounter data.
https://greathospital.com:8100/sites/123/Encounter?patient=1
Retrieve the patient problem list data.
https://greathospital.com:8100/sites/123/Condition?patient=1
https://greathospital.com:8100/sites/123/Condition?patient=1&date=2017-05-30
https://greathospital.com:8100/sites/123/Condition?patient=1&date=ge2017-06-07&date=le2017-06-08
Retrieve the patient procedures performed data.
https://greathospital.com:8100/sites/123/Procedure?patient=1
https://greathospital.com:8100/sites/123/Procedure?patient=1&date=2017-05-30
https://greathospital.com:8100/sites/123/Procedure?patient=1&date=ge2017-06-07&date=le2017-06-08
Retrieve the patient smoking status data.
https://greathospital.com:8100/sites/123/Observation?patient=1&code=72166-2
https://greathospital.com:8100/sites/123/Observation?patient=1&code=72166-2&date=2017-05-30
https://greathospital.com:8100/sites/123/Observation?patient=1&code=72166-2&date=ge2017-06-07&date=le2017-06-08
Retrieve the patient vital signs data.
https://greathospital.com:8100/sites/123/Observation?patient=1&category=vital-signs
https://greathospital.com:8100/sites/123/Observation?patient=1&category=vital-signs&date=2017-05-30
https://greathospital.com:8100/sites/123/Observation?patient=1&category=vital-signs&date=ge2017-06-07&date=le2017-06-08
Retrieve the patient lab results data.
https://greathospital.com:8100/sites/123/Observation?patient=1&category=laboratory
https://greathospital.com:8100/sites/123/Observation?patient=1&category=laboratory&date=2017-05-30
https://greathospital.com:8100/sites/123/Observation?patient=1&category=laboratory&date=ge2017-06-07&date=le2017-06-08
Retrieve the patient goals data.
https://greathospital.com:8100/sites/123/Goal?patient=1
https://greathospital.com:8100/sites/123/Goal?patient=1&date=2017-05-30
https://greathospital.com:8100/sites/123/Goal?patient=1&date=ge2017-06-07&date=le2017-06-08
Retrieve the patient immunization data.
https://greathospital.com:8100/sites/123/Immunization?patient=1
https://greathospital.com:8100/sites/123/Immunization?patient=1&date=2017-05-30
https://greathospital.com:8100/sites/123/Immunization?patient=1&date=ge2017-06-07&date=le2017-06-08
Retrieve the patient assessment and treatment plan data.
https://greathospital.com:8100/sites/123/CarePlan?patient=1
https://greathospital.com:8100/sites/123/CarePlan?patient=1&date=2017-05-30
https://greathospital.com:8100/sites/123/CarePlan?patient=1&date=ge2017-06-07&date=le2017-06-08
Retrieve the patient health concerns data.
https://greathospital.com:8100/sites/123/Condition?patient=1
https://greathospital.com:8100/sites/123/Condition?patient=1&date=2017-05-30
https://greathospital.com:8100/sites/123/Condition?patient=1&date=ge2017-06-07&date=le2017-06-08
Retrieve the patient home medication data.
https://greathospital.com:8100/sites/123/MedicationStatement?patient=1
https://greathospital.com:8100/sites/123/MedicationStatement?patient=1&date=2017-05-30
https://greathospital.com:8100/sites/123/MedicationStatement?patient=1&date=ge2017-06-07&date=le2017-06-08
Retrieve the patient administered medication data.
https://greathospital.com:8100/sites/123/MedicationAdministration?patient=1
https://greathospital.com:8100/sites/123/MedicationAdministration?patient=1&date=2017-05-30
https://greathospital.com:8100/sites/123/MedicationAdministration?patient=1&date=ge2017-06-07&date=le2017-06-08
Retrieve the patient medication order and prescription data.
https://greathospital.com:8100/sites/123/MedicationRequest?patient=1
https://greathospital.com:8100/sites/123/MedicationRequest?patient=1&date=2017-05-30
https://greathospital.com:8100/sites/123/MedicationRequest?patient=1&date=ge2017-06-07&date=le2017-06-08
Retrieve the patient allergy data.
https://greathospital.com:8100/sites/123/AllergyIntolerance?patient=1
https://greathospital.com:8100/sites/123/AllergyIntolerance?patient=1&date=2017-05-30
https://greathospital.com:8100/sites/123/AllergyIntolerance?patient=1&date=ge2017-06-07&date=le2017-06-08
Retrieve the patient medical device data.
https://greathospital.com:8100/sites/123/Device?patient=1
https://greathospital.com:8100/sites/123/Device?patient=1&date=2017-05-30
https://greathospital.com:8100/sites/123/Device?patient=1&date=ge2017-06-07&date=le2017-06-08
After retrieving the patient id from the Patient Selection Request it can be used to query the C-CDA R2.1 Continuity of Care Document for that patient. In the below queries we will use a patient id of 1.
Retrieve the reference to the patient C-CDA document.https://greathospital.com:8100/sites/123/DocumentReference?patient=1
https://greathospital.com:8100/sites/123/DocumentReference?patient=1&date=2017-05-30
https://greathospital.com:8100/sites/123/DocumentReference?patient=1&date=ge2017-06-07&date=le2017-06-08
Retrieve the patient C-CDA document using the document reference.
https://greathospital.com:8100/sites/123/Binary/CDA_827550c4-7ebe-43fa-ad2f-aa18c8ebbf44
The following table shows the mapping between the Meaningful Use 3 Common Clinical Data Set elements to the corresponding FHIR Resource.
Common Clinical Data Set | FHIR Resource | FHIR Specification Reference |
---|---|---|
Patient Demographics including Name, Sex, Date of Birth, Race, Ethnicity, Preferred Language | Patient | Patient |
Smoking Status | Observation | Observation |
Problems | Condition | Condition |
Medications | MedicationRequest, MedicationStatement | MedicationRequest, MedicationStatement |
Medication Allergies | AllergyIntolerance | AllergyIntolerance |
Laboratory Tests | ProcedureRequest | ProcedureRequest |
Laboratory Values(s)/Result(s) | Observation | Observation |
Vital Signs | Observation | Observation |
Procedures | Procedure | Procedure |
Care Team Member(s) | CareTeam | CareTeam |
Immunizations | Immunization | Immunization |
Unique Device Identifier(s) for a Patient’s Implantable Device(s) | Device | Device |
Assessment and Plan of Treatment | CarePlan | CarePlan |
Goals | Goal | Goal |
Health Concerns | Condition | Condition |