Lab Result

The Lab Results feature allows the user to view the laboratory data, explanations of lab data and lab measurements. You can add or update analytes for a given lab result, but only if the lab result was created by you. See the POST /patients/{patientid}/documents/labresult API on how to add lab result documents. 

Was this information helpful? Yes | No What went wrong? Incomplete or incorrect information | Irrelevant Content | Others

Endpoints

Get patient's lab results
GET
/v1/{practiceid}/chart/{patientid}/labresults

Retrieves the patients laboratory results. Note: This endpoint may rely on specific settings to be enabled in athenaNet Production to function properly that are not required in other environments. Please see <a href="https://docs.athenahealth.com/api/resources/best-practices-and-troubles… Rollout of APIs</a> for more information if you are experiencing issues.

Was this information helpful? Yes | No What went wrong? Incomplete or incorrect information | Irrelevant Content | Others
Try in Postman

Input Parameters

Expand all

❙ required

practiceid integer practiceid
patientid integer patientid
allresultsbyencounterid integer ID used to return lab results for a specific encounter.
exactduplicatedocumentid integer ID used when the lab results sends the exact same result multiple times.
supersededdocumentid integer ID used when the lab sends a result and later sends a more complete version of the result with additional information.
startdate string Filter lab orders not individual results that are on or after this date. Example: startdate=6/21/2015. If no startdate is specified, all prior lab orders will be included until enddate if specified.
labresultstatus string Filter the results based on the lab result's result status. Since the result status is a free text field, this list is not exhaustive, but does represent a majority of the used statuses.
showtemplate string If true, interpretation template added to the document is also returned.
showportalonly string If true, only documents published to the portal at the time of this call are returned.
showhidden string Includes the lab results and analytes marked as hidden. Hidden lab results and analytes are created when they are manually entered, for example on the qm tab or in flowsheets.
showabnormaldetails string Include the translation of the abnormalflag into HL7 code standards.
enddate string Filter lab orders not individual results that are on or before this date. Example: enddate=1/21/2018. If no enddate is specified, all lab orders found since startdate will be included if specified.
departmentid integer The athenaNet department id.
hideduplicate string If true, filters out results that have been marked as an as exact duplicate of another.
analyteresultstatus string Filter the results based on the analyte's result status. Since the result status is a free text field, this list is not exhaustive, but does represent a majority of the used statuses.
limit integer Number of entries to return (default 1000, max 10000)Please note that this endpoint has a different default and max than normal.
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
analytes array Individual lab result observations/analytes
attachmentexists string This flag depicts if the lab result has a scanned document attachment or not.
description string Description for this lab result
facilityid integer The ID of the clinical provider associated with this clinical document. Clinical providers are a master list of providers throughout the country. These include providers as well as radiology centers, labs and pharmacies.
internalnote string The 'Internal Note' attached to this document.
interpretationtemplate object The interpretation template added to the lab result.
labresultdate string Observation date associated with this lab result
labresultdatetime string The observation date and time associated with this lab result. Returned in mm/dd/yyyy hh24:mi:ss format.
labresultid integer Athena ID for this lab result
labresultloinc string The LOINC for the result document or associated order.
labresultnote string Additional note associated with this lab result, if any
orderid integer The athena ID of the associated order document
patientnote string The external note for the patient.
performinglabaddress1 string This is the address1 field of the performing lab. For point-of-care tests this is the department. Otherwise, it is the clinical provider
performinglabaddress2 string This is the address2 field of the performing lab. For point-of-care tests this is the department. Otherwise, it is the clinical provider
performinglabcity string This is the city of the performing lab. For point-of-care tests this is the department. Otherwise, it is the clinical provider
performinglabname string This is the name of the performing lab. For point-of-care tests this is the department. Otherwise, it is the clinical provider
performinglabstate string This is the state of the performing lab. For point-of-care tests this is the department. Otherwise, it is the clinical provider
performinglabzip string This is the zip code of the performing lab. For point-of-care tests this is the department. Otherwise, it is the clinical provider
priority string Document priority, when available. 1 is high, 2 is normal. Some labs use other numbers or characters that are lab-specific.
providerid integer The provider ID for this document.
resultstatus string The status of the result (e.g., "final", "preliminary", "corrected", etc.)
Example Code