Order Results API

RSLTAddress

Mailing address.
street
​string

Street address.

city
​string

City.

state
​string

State.

zip
​string

ZIP code.

RSLTVitals

A patient vital measurement recorded with the order.
code
​string

Vital measurement code.

loincCode
​string

LOINC code for the vital measurement.

value
​string

Vital measurement value.

RSLTPatient

Patient demographics from the results report.
firstName
​string

Patient first name.

lastName
​string

Patient last name.

middleName
​string

Patient middle name.

title
​string

Patient title (e.g. "Mr", "Ms").

dob
​string

Patient date of birth.

gender
​string

Patient gender.

ssn
​string

Patient social security number.

externalPatientId
​string

Also known as MRN. ID used by the client.

chartNumber
​string

Chart number.

medicaidNum
​string

Medicaid number.

billingMethod
​string

Billing method.

billingType
​string

Billing type code.

billingTypeDescription
​string

Human-readable billing type description.

​RSLTAddress

Mailing address.

​RSLTVitals[]

Patient vitals recorded with the order.

ResultOrderingProvider

Ordering provider information.
firstName
​string

Provider first name.

lastName
​string

Provider last name.

number
​string

Provider number.

npi
​string

National Provider Identifier.

upin
​string

Unique Physician Identification Number (legacy).

taxonomyCode
​string

Taxonomy code for the physician. Required for the results service, not required for the accession service.

OrderingAccount

The account that placed the order.
number
​string

Ordering account number.

name
​string

Ordering account name.

phone
​string

Ordering account phone number.

fax
​string

Ordering account fax number.

specialtyCode
​string

Account specialty code.

​RSLTAddress

Mailing address.

RSTResults

A single result line (analyte) within an ordered test.
resultCode
​string

Labcorp result code.

resultName
​string

Display name of the result analyte.

resultValue
​string

Reported result value.

resultValueQuantity
​string

Numeric quantity form of the result value.

resultValueString
​string

String form of the result value.

units
​string

Result units.

displayUnits
​string

Display-friendly units string.

referenceRangeLo
​string

Low end of the reference range.

referenceRangeHi
​string

High end of the reference range.

referenceRangeText
​string

Includes reference range comments as concatenated fields, and reference range low and high with units (e.g. "45-67 um/l").

resultStatus
​string

HL7 result status code.

resultStatusDescription
​string

Human-readable result status description.

abnormalIndicator
​string

Abnormal flag (e.g. "H" for high, "L" for low, "A" for abnormal).

interpretationCode
​string

Interpretation code.

noAbnormalFlag
​string

No-abnormal flag.

resultType
​string

Result type.

resultLoincCode
​string

LOINC code for the result analyte.

procedureClass
​string

Procedure class.

labCode
​string

Code of the performing laboratory.

labName
​string

Name of the performing laboratory.

labDirectorName
​string

Lab director name.

labSpecimenNum
​string

Lab specimen number.

observationDateTime
​string · date-time

Timestamp the observation was made.

resultFollowFlag
​string

Result follow flag.

resultSuppressFlag
​string

Result suppress flag.

resultComments
​string

All concatenated comments in sequence.

RSTOrderedItems

A test ordered on the accession, with its performed result items.
testCode
​string

Labcorp test code.

testName
​string

Display name of the test.

testLoincCode
​string

LOINC code for the ordered test.

testStatus
​string

HL7 test status code.

testStatusDescription
​string

Human-readable test status description.

testType
​string

Test type (panel, super panel, or test).

testSuppressFlag
​string

Test suppress flag.

testFollowFlag
​string

Test follow flag.

​RSTResults[]

Individual result lines produced by this test.

RSTDiagnosisCodes

A diagnosis code associated with the order.
diagnosisCode
​string

Diagnosis code value.

diagnosisCodeInd
​string

Diagnosis code indicator (e.g. ICD version).

diagnosisCodeShortDescription
​string

Short description of the diagnosis code.

physicianTypeInd
​string

Physician type indicator.

RSTAccessionsComments

A comment attached to the accession.
commentType
​string

Comment type (e.g. SYNOPSIS, ACCESSION, PROFESSIONAL DIAGNOSIS, CLINICAL DIAGNOSIS, ENDOSCOPIC FINDINGS, MICROSCOPIC DESCRIPTION, GROSS DESCRIPTION).

comment
​string

Comment text.

labSpecimenNum
​string

Lab specimen number. Present only for specialty lab messages when a lab specimen number is sent. There could be multiple lab specimen numbers for a given accession.

ResultsReportContainer

A report container grouping ordered items with a report timestamp and status.
number
​string

Report container number.

status
​string

Report status code.

reportDateTime
​string

Timestamp the report was generated.

​object[]

Tests included in this report container.

RSTTags

A metadata tag on the accession.
name
​string

Tag name.

type
​string

Tag type.

ExclusionFlags

Flags indicating exclusion conditions on the accession.
containsOTSTest
​boolean

Categorized as an occupational testing accession, by the chain of custody test present in the order.

containsRegulatedPerfLabs
​boolean

Whether the accession contains regulated performance labs.

RSTAccessionsHeader

The full results header returned for an accessioned order. Contains patient demographics, ordering provider, ordered tests, and per-test results.
number
​string

Accession number.

key
​string

Composite key identifying this accession. Period-delimited concatenation of accession number, order source, order date (yyyy-mm-dd), and collection date (yyyy-mm-dd). E.g. "12345678901.LCLS.2019-09-02.2019-09-01".

reportStatus
​string

Report status code (e.g. "F" for Final, "P" for Preliminary).

reportStatusDescription
​string

Human-readable report status description.

reportDateTime
​string · date-time

Timestamp the report was issued.

lastUpdatedDateTime
​string · date-time

Timestamp of the most recent update to the report.

collectionDateTime
​string · date-time

Specimen collection timestamp.

collectionTimeOffset
​string

UTC offset for collection time.

orderedDateTime
​string · date-time

Timestamp the order was placed.

orderedTimeOffset
​string

UTC offset for ordered time.

reportTimeOffset
​string

UTC offset for report time.

receivedDateTime
​string · date-time

Timestamp the specimen was received by the lab.

source
​string

System of origin.

brandCode
​string

Brand code (e.g. "LC" for Labcorp).

responsibleLab
​string

Responsible lab code.

responsibleLabName
​string

Responsible lab name.

lpid
​string

Labcorp patient identifier.

coPathId
​string

CoPath identifier (anatomic pathology system).

externalOrderAccountNum
​string

External order account number.

externalOrderRequisitionNum
​string

External order requisition number.

faxable
​boolean

Whether the report can be faxed.

patientReportReleaseStatus
​string

Patient report release status indicator.

containsCovidTest
​boolean

Whether the accession contains a COVID-19 test.

nonReportableReasons
​string[]

Reasons the report may not be released, if any.

​RSLTPatient

Patient demographics from the results report.

Ordering provider information.

​OrderingAccount

The account that placed the order.

​RSTOrderedItems[]

Tests ordered on this accession.

​RSTDiagnosisCodes[]

Diagnosis codes associated with the order.

​RSTAccessionsComments[]

Comments attached to the accession.

copyToAccountNumbers
​string[]

Account numbers that receive copies of the report.

Report containers (number, status, ordered items, report timestamp).

​RSTTags[]

Metadata tags on the accession.

​ExclusionFlags

Flags indicating exclusion conditions on the accession.

ValidationIssue

id
​string · required

Machine-readable error identifier for programmatic handling.

path
​string · required

JSONPath-relative expression identifying the field that caused the issue. An empty string indicates a request-level error not attributable to a specific field.

message
​string · required

Human-readable description of the issue.

ErrorResponse

​ValidationIssue[] · required

One or more issues that prevented the request from succeeding.