Data accessed¶
The service reads data through Epic's FHIR R4 APIs. It can call only the 52 APIs on its Epic app registration, which are all read or search APIs and are listed on this page.
Which patients and visits¶
You decide which visits the service retrieves. You build the patient lists it reads, and you agree with us which kind of visit you want us to load: emergency department (ED) visits, for example.
The service reads:
- the patient lists you make available to it,
- the demographics and coverage of each patient on a list,
- each of those patients' recent encounters, to find the visit, and
- the documentation recorded on that encounter.
It retrieves documentation only for those encounters, not for a patient's other visits. It reads your organization's own chart, not records received from other organizations: it has none of Epic's "Outside Record" APIs.
If you don't use a patient list, the service finds each visit in Epic by MRN and CSN, and reads the same data for it.
ED visits that become an admission or observation stay¶
Epic may keep the stay on the same encounter as the ED visit. The service then retrieves that encounter's documentation, but our platform receives the ED portion only: from arrival in the ED to departure from it.
It also receives the admission or observation order and the disposition. For reference, it receives the history and physical (H&P), consult notes, discharge summary, discharge instructions and discharge medication list. Nothing else from the stay is passed on. Your HIM or coding lead can change which document types are included.
APIs¶
Names are as they appear in Epic's API catalog. The service uses both the Read and the Search API for each row, unless the row says read only.
| FHIR resource | Epic API | Used for |
|---|---|---|
| List | Patient List | Finding patients on your system lists |
| Patient | Demographics | Demographics. Search finds a patient by MRN if you don't use a patient list. |
| Encounter | Patient Chart | The visit: CSN, status, times, locations and disposition |
| Coverage | Patient Insurance Information | Payer |
| DocumentReference, Binary | Clinical Notes | Clinical notes and their full signed content |
| DocumentReference, Binary | Radiology Results | Radiology reports |
| MedicationAdministration | Medication administrations, including every infusion event | |
| MedicationRequest | Signed Medication Order | Medication orders |
| Medication | Organization Med List | Drug names on orders and administrations. Read only. |
| ServiceRequest | Orders | Lab, imaging, admission and observation orders |
| Procedure | Orders | Procedures performed |
| Condition | Encounter Diagnosis, Problems, Reason for Visit | The visit's diagnoses, problems and chief complaint |
| DiagnosticReport | Results | Lab, imaging and ECG results |
| Observation | Labs, Vital Signs, Flowsheets, Lines Drains Airways | Lab values, vital signs, triage and assessment flowsheet rows, and IV lines |
| Practitioner, PractitionerRole | Organizational Directory | The treatment team. Read only. |
| Location | Organizational Directory | Department and location names. Read only. |
Binary, which carries a document's content, is always read only.
Supplemental APIs¶
Epic organizations file some documents in different places. These APIs let the service find them wherever your build puts them, for the same encounters.
| FHIR resource | Epic API | Used for |
|---|---|---|
| DocumentReference, Binary | Document Information | Discharge instructions and scanned documents that aren't filed as clinical notes |
| DocumentReference, Binary | Labs | Pathology and microbiology narratives |
| Procedure | Surgeries | Procedures recorded as surgeries, not orders |
| Device | Lines, Drains, Airways | IV lines that aren't available as observations |