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

Endpoints

Primary

GET

Get lab results for a patient's visit in the
hospital.

GET

Return the lab and imaging results for a given patient stay in the
hospital

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

Try in Postman

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.

analytes object Individual lab result observations/analytes.

abnormalflag string Status measurement relative to normal (low, high, normal, abnormal).

abnormalhl7code string

abnormalhl7name string The HL7 description related to the abnormal flag.

analytedate string Date when this observation was recorded

analyteid integer Athena ID for the given lab result observation/analyte.

analytename string Name/description specific to this analyte.

code string Logical Observation Identifiers or a custom LIS code ID for the analyte if available.

codeset string Logical Observation Identifiers Names or a custom LIS code set.

note string Additional note for this analyte, if applicable.

referencerange string Reference range of values accepted as normal for this observation.

resultcategory string E.g., Abnormal, Normal, Unknown, Other, or Critical.

units string Units for the analyte entry, if provided by the lab.

value string Value recorded for this observation.

clinicalproviderid string Clinical Provider ID for a given lab result

labresultcategory string E.g., Abnormal, Normal, Unknown, Other, or Critical.

labresultdate string Observation date associated with this lab result. Returned in mm/dd/yyyy hh24:mi:ss format.

labresultnote string Additional note associated with this lab result, if any.

labresultstatus string The status of the result (e.g., "final", "preliminary", corrected", "cancelled", "complete", "incomplete", etc.).

loinccode string The LOINC code for the result document or associated order.

loincdescription string The LOINC description for the result document or associated order.

name string The athena description for the result document or associated order.

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

Try in Postman

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.

abnormalflag string The status measurement relative to a normal result (eg. LOW, HIGH, ABNORMAL etc.).

category string The characterization of the observation. One of Abnormal, Critical, Normal, Other or Unknown.

code string The code value identifying the observation, in whatever codeset is specified in the CODESET attribute.

codedescription string The description of the code for the individual observation.

codeset string The codeset identifying the observation.

interpretation string For Imaging results, the interpretation of the image.

note string The additional note, if any, for this observation.

observationdate string The datetime that the observation was made, returned in ISO format (yyyy-mm-ddThh:mm:ss+|-hh:mm).

observationid integer The identifier for the individual observation.

referencerange string [Lab Only] The range of normal values for an observation.

units string [Lab Only]. The units associated with the analyte value, as provided by the lab.

value string [Lab Only]. The measured value for the analyte being tested.

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