EMR Integration

Introduction Epic Integration GET/POST Integration Examples

Introduction

Integrating BiliRecs into your Electronic Medical Record (EMR) system is straightforward. A simple embedded link within the EMR can launch BiliRecs, automatically populating the infant's total serum bilirubin and post-menstrual age or timestamp of sample collection. No protected health information is transmitted. The tool immediately opens to the appropriate treatment recommendation.

Epic Launch

Epic users are encouraged to utilize the official integration available through the Epic Showroom listing for BiliRecs. This method enables streamlined SMART on FHIR-based access directly from within Epic Hyperspace.

Work with your Epic Technical Services team to configure this integration, enabling clinicians to open BiliRecs with a single click and have relevant patient information auto-populated.

If SMART launch is not feasible, BiliRecs can alternatively be launched using GET or POST data via a standard web link as detailed below.

GET/POST Integration

BiliRecs supports direct integration via query string parameters. You may also use HTTP POST if preferred, though GET is recommended for ease of implementation.

Age-Based Calculation

hours:: The infant's age in hours at the time of blood draw
total:: Total serum bilirubin measurement
gestAge:: (Optional) Gestational age in weeks
Defaults to 40 if not specified
units:: (Optional) Measurement units: "us" for mg/dL or "si" for µmol/L
Defaults to "us"

Time-Based Calculation (Recommended)

dob:: Date and time of birth
time:: Date and time of sample collection
total:: Total serum bilirubin measurement
gestAge:: (Optional) Gestational age in weeks
Defaults to 40 if not specified
units:: (Optional) Measurement units: "us" for mg/dL or "si" for µmol/L
Defaults to "us"

Dates can be passed in many common formats such as "YYYY-MM-DD HH:MM:SS", "MM/DD/YYYY HH:MM", or Unix Timestamps. If parsing fails, an error will be shown.

To visualize trends, you may supply multiple hours/time and total values as indexed arrays. The latest reading will determine the recommendation.

Examples

Example using hours:

https://bilirecs.stanfordchildrens.org/?hours=100&total=13.5

Example using DOB/time and metric units:

https://bilirecs.stanfordchildrens.org/?dob=2025-01-01 12:17&time=2025-01-05 16:12&total=256&gestAge=36&units=si

Example using multiple bilirubin values over time:

https://bilirecs.stanfordchildrens.org/?dob=03/10/2025 15:12:17&gestAge=39&time[1]=03/13/2025 10:56:43&total[1]=16&time[2]=03/14/2025 03:36:23&total[2]=16.2&time[3]=03/14/2025 22:36:23&total[3]=12&time[4]=03/15/2025 02:32:49&total[4]=10.6