Skip to content

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