Read clinical data from Epic on FHIR (R4): patients, conditions, observations (labs, vitals, smoking history), medications, procedures, immunizations, diagnostic reports, documents and more.
Changelog
2 versions
v1.0.1
Latest
- Production readiness: OAuth2 authorize/token endpoints are now configurable per organisation. Set epicOauthBaseUrl explicitly, or let it derive from epicFhirBaseUrl (standard Epic interconnect layout); the public sandbox remains the default. The OAuth audience (aud) now follows the configured FHIR base URL.
- Internal: shared utilities consolidated into lib.js (commons.js removed) to follow the repository convention.
v1.0.0
- Initial release. Read clinical FHIR (R4) data from Epic: Patient, Condition, Observation (labs, vitals, smoking history), Medication, MedicationRequest, Procedure, CarePlan, Goal, Immunization, DiagnosticReport, DocumentReference and Device.
- Appointment support: Get Appointment and polling triggers New Appointment, Updated Appointment, Cancelled Appointment.
- Get components for fetching a single resource by FHIR ID: Get Patient, Get Diagnostic Report, Get Procedure and Get Medication Request.
- Make Api Call component for arbitrary authorized FHIR requests.
Authentication
| Type | Details |
|---|---|
| OAuth 2 | — |
Triggers
3Cancelled Appointment
Triggers when an appointment of a patient is cancelled in Epic. Emits all available appointment data.
New Appointment
Triggers when a new appointment is created for a patient in Epic. Emits all available appointment data.
Updated Appointment
Triggers when an appointment of a patient is updated in Epic (time, status or other changes). Emits all available appointment data.
Actions
20
Find Care Plans
Retrieve the care plans recorded for a patient in Epic. Returns up to one page of results (Epic's default page size).
Find Conditions
Retrieve the conditions (problems/diagnoses) recorded for a patient in Epic. Returns up to one page of results (Epic's default page size).
Find Devices
Retrieve the devices (implants/equipment) associated with a patient in Epic. Returns up to one page of results (Epic's default page size).
Find Diagnostic Reports
Retrieve the diagnostic reports (with full details) for a patient in Epic. Returns up to one page of results (Epic's default page size).
Find Documents
Retrieve the document references (clinical documents) for a patient in Epic. Returns up to one page of results (Epic's default page size).
Find Goals
Retrieve the goals recorded for a patient in Epic. Returns up to one page of results (Epic's default page size).
Find Immunizations
Retrieve the immunization records for a patient in Epic. Returns up to one page of results (Epic's default page size).
Find Lab Results
Retrieve laboratory observations (lab results) recorded for a patient in Epic. Returns up to one page of results (Epic's default page size).
Find Patients
Search for patients in Epic by demographics (name, birth date) or by an MRN/identifier. Provide at least one search criterion. Returns up to one page of results (Epic's default page size).
Find Procedures
Retrieve the procedures performed for a patient in Epic. Returns up to one page of results (Epic's default page size).
Find Medication Requests
Retrieve the medication orders (prescriptions) for a patient in Epic. Returns up to one page of results (Epic's default page size).
Find Vital Signs
Retrieve vital-sign observations (e.g. blood pressure, heart rate, temperature) recorded for a patient in Epic. Returns up to one page of results (Epic's default page size).
Get Appointment
Retrieve an appointment from Epic by its FHIR ID, including date, time, status, participants and all other available data.
Get Diagnostic Report
Retrieve a single Diagnostic Report resource from Epic by its FHIR ID, including result references and attached report documents (presented form).
Get Medication
Retrieve a single Medication resource from Epic by its FHIR ID. The Medication ID is typically taken from a Medication Request's medicationReference.
Find Smoking History
Retrieve social-history observations (including smoking/tobacco use history) recorded for a patient in Epic. Returns up to one page of results (Epic's default page size).
Get Medication Request
Retrieve a single Medication Request (medication order) resource from Epic by its FHIR ID, including the ordered medication, requester and dosage instructions.
Get Patient
Retrieve a single Patient resource from Epic by its FHIR ID. Returns patient demographics: name, identifiers, birth date, gender, contact details and address.
Get Procedure
Retrieve a single Procedure resource from Epic by its FHIR ID, including the procedure code, status, category and when it was performed.
Make Api Call
Performs an arbitrary authorized API call against the Epic FHIR R4 API.
Additional Scopes:
user/Patient.read
user/Condition.read
user/Observation.read
user/Medication.read
user/MedicationRequest.read
user/Procedure.read
user/CarePlan.read
user/Goal.read
user/Immunization.read
user/DiagnosticReport.read
user/DocumentReference.read
user/Device.read
user/Appointment.read