ABN Service API

TestAbnRequest

Request payload for /checkAbnByTestCodes.
accountNumber
​string · required

Labcorp account number identifying the ordering provider.

testCodes
​string[] · required

Test codes to evaluate.

diagCodes
​string[] · required

Diagnosis codes (typically ICD-10) for the lab work.

patientName
​string · required

Patient name as it should appear on the ABN PDF.

identificationNumber
​string

Identifier printed on the ABN PDF to correlate with lab/clinic records. Truncated to 20 characters when rendered into the PDF.

sourceName
​string

Identifies the source making the request; included in logs. Truncated to 15 characters downstream.

sourceVersion
​string

Version of the calling software; included in logs. Truncated to 20 characters downstream.

includeABNContent
​boolean | null

When true, the response includes a base64-encoded ABN PDF in abnContents.

includeDetails
​boolean | null

When true, the response includes per-test detail in abnTests.

nbrOfPrintCopies
​integer · int32

Retained for backward compatibility; value is ignored by the service.

TestAbnResponseType

Body returned on the 200 (success) path.
outputType
​string

"Success" on the 200 path. Other values are returned as 500 with outputType set to "FAILURE".

isABNRequired
​boolean | null

True when an ABN is required for this combination.

estCost
​integer · int32

Estimated cost not covered by Medicare.

abnContents
​string

Base64-encoded ABN PDF. Populated only when includeABNContent was true in the request.

contentType
​string

MIME content type of abnContents when present.

​AbnTest[]

Per-test breakdown. Populated when includeDetails was true.

nonSpecificDiagnosisCodes
​string[]

Submitted diagnosis codes that are too non-specific to support medical necessity.

invalidDiagnosisCodes
​string[]

Submitted diagnosis codes that are not recognized.

​Message[]

Informational, warning, or error messages from the service.

AbnTest

Per-test detail. Present in `abnTests` when `includeDetails` is true.
testCode
​string
testDesc
​string
testPrice
​integer · int32
ruoIndicator
​boolean

True when the test is research-use-only (always requires an ABN).

ruoPrice
​integer · int32
ruoDesc
​string
ruoPriceNotFound
​boolean
ruoDescNotFound
​boolean
​AbnCpt[]

CPTs flagged for Medicare frequency limits.

​AbnCpt[]

CPTs whose diagnosis does not support medical necessity.

AbnCpt

CPT detail shared by frequency-limit and medical-necessity entries.
code
​string
desc
​string
price
​integer · int32
multiplier
​integer · int32
priceNotFound
​boolean
descNotFound
​boolean

Message

Structured message with a machine-readable code, human-readable text, and severity type.
code
​string
text
​string
type
​string

Severity classifier, typically ERROR, WARNING, or INFO.

StatusBean

Error envelope returned on the 500 path.
outputType
​string

Typically "FAILURE" when the evaluation did not succeed. May be absent on some error paths.

statusDesc
​string

Short description of the failure.

​Message[]

Service messages associated with the failure, when present.