Lab Results
The Lab Results feature allows the user to view the laboratory data, explanations of lab data and lab measurements.
Was this information helpful?
Yes | No
Thank you for your feedback!
What went wrong?
Incomplete or incorrect information |
Irrelevant Content
| Others
Submit
Get lab results for a patient's visit in the hospital.
GET
/v1/{practiceid}/stays/{stayid}/labresults
BETA: Retrieves lab result details for a hospital stay
Was this information helpful?
Yes | No
Thank you for your feedback!
What went wrong?
Incomplete or incorrect information |
Irrelevant Content
| Others
Submit
Input Parameters
Expand all❙ required
practiceid
integer
practiceid
stayid
integer
stayid
showabnormaldetails
boolean
Include the translation of the abnormalflag into HL7 code standards.
datefilter
string
Filter lab orders not individual results within a specific time period. Prefix: eq - specific, le - inclusive less, lt - exclusive less, ge - inclusive greater, gt - exclusive greater, separate start and end date with space. Example: ge2015-06-1 le2015-06-22
limit
integer
Number of entries to return (default 1500, max 5000)
offset
integer
Starting point of entries; 0-indexed
THIRDPARTYUSERNAME
string
User name of the patient in the third party application.
PATIENTFACINGCALL
boolean
When 'true' is passed we will collect relevant data and store in our database.
Output Parameters
Expand all
labresultid
integer
Athena ID for this lab result.
labtests
object
Individual lab test or panel.
orderid
integer
The unique athena ID of this instance of the order.
Example Code
Return the lab and imaging results for a given patient stay in the hospital
GET
/v1/{practiceid}/stays/{stayid}/results
The lab and imaging results for a given patient stay in the hospital.
Was this information helpful?
Yes | No
Thank you for your feedback!
What went wrong?
Incomplete or incorrect information |
Irrelevant Content
| Others
Submit
Input Parameters
Expand all❙ required
practiceid
integer
practiceid
stayid
integer
stayid
THIRDPARTYUSERNAME
string
User name of the patient in the third party application.
PATIENTFACINGCALL
boolean
When 'true' is passed we will collect relevant data and store in our database.
Output Parameters
Expand all
category
string
The characterization of the result. One of Abnormal, Critical, Normal, Other or Unknown.
clinicalproviderid
integer
Clinical Provider ID for a given imaging result
code
string
The code value identifying the performed procedure, in whatever codeset is specified in the CODESET attribute.
codedescription
string
The description of the code for the result.
codeset
string
The codeset identifying the result
name
string
The athena description of the test that was performed.
note
string
The note associated with the result, if any.
observations
array
The set of individual observations for the performed tests.
orderid
integer
The ID of the order with which the result is associated.
ordertypegroupname
string
The class of the result (LAB or IMAGING)
resultdate
string
The timestamp when the result was released returned in ISO format (yyyy-mm-ddThh:mm:ss+|-hh:mm).
resultid
integer
The athena identifier for the returned result.
status
string
The status of the result (eg. Complete or Preliminary).
Example Code