Test Code Lookup and Pricing API

TestInfoGridRequestV2

Grid search request body. This service requires `sendingFacility`, `sendingApplication`, and `accountNumber`. Identity fields are stripped before the upstream call; other fields are forwarded unchanged.
sendingFacility
​string · required

The HL7 sending facility identifier (CSID). Must match an active service subscription configuration for the caller. Trimmed and matched case-sensitively. Not forwarded upstream.

sendingApplication
​string · required

The HL7 sending application identifier (mnemonic). Must match an active service subscription configuration for the caller. Trimmed and matched case-sensitively. Not forwarded upstream.

accountNumber
​string · required

Partner account number. Required by this service — absent, blank, whitespace-only, or non-string values return 400 before any upstream call.

identifierType
​string

Type of identifier used for the search. Supported values:

  • KEYWORD — free-text / non-numeric search (for example a published code or name fragment)
  • TESTCODE — numeric Labcorp test number search

Unrecognized types are not useful for search.

identifierValue
​string

Search value for the chosen identifierType: keyword text when type is KEYWORD; numeric Labcorp test number when type is TESTCODE.

publishedCode
​string

Optional published test code filter.

hospital
​boolean

When true, search in the hospital catalog context.

sessionId
​string

Optional session identifier for the upstream search context.

expandedSearch
​boolean

When true, expands the search beyond the default match set.

orderable
​boolean

When true, restrict results to orderable tests.

Metadata

Optional metadata attached to a grid search result row.
authorizedBy
​string
value
​string

StorageInfo

Storage/container detail for a grid search result row.
storageName
​string
containerName
​string

TestInfoResult

A single test-info row in a grid search response.
testNumber
​string
labSystemCode
​string
testName
​string
specimenType
​string
primarySpecimenContainer
​string
tat
​string
storage
​string
specialInstructions
​string
alternateSpecimenContainer
​string
alternateTestNames
​string
methodology
​string
orderable
​boolean
published
​boolean
publishedCode
​string
resultCodes
​string[]
sendOut
​boolean
​Metadata

Optional metadata attached to a grid search result row.

​StorageInfo[]
decile
​integer · int32
orderedCount
​integer · int32

TestInfoGridResponse

Grid search response. Successful (**2xx**) bodies are returned unchanged.
totalEsRecordCount
​integer · int32
totalEsPublishedRecordCount
​integer · int32
totalEsUnpublishedRecordCount
​integer · int32
totalEsOrderableRecordCount
​integer · int32
totalEsUnorderableRecordCount
​integer · int32
totalRecordCount
​integer · int32
totalPublishedRecordCount
​integer · int32
totalUnpublishedRecordCount
​integer · int32
totalOrderableRecordCount
​integer · int32
totalUnorderableRecordCount
​integer · int32
contractBookNumber
​string
​TestInfoResult[]

Matching test-info rows from the grid search.

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.

MultiTestCostRequest

Multi-test cost request body. This service requires `sendingFacility`, `sendingApplication`, and `accountNumber`. Identity fields are stripped before the upstream call; `testNumbers` and other fields are forwarded unchanged.
sendingFacility
​string · required

The HL7 sending facility identifier (CSID). Must match an active service subscription configuration for the caller. Trimmed and matched case-sensitively. Not forwarded upstream.

sendingApplication
​string · required

The HL7 sending application identifier (mnemonic). Must match an active service subscription configuration for the caller. Trimmed and matched case-sensitively. Not forwarded upstream.

accountNumber
​string · required

Partner account number. Required by this service — absent, blank, whitespace-only, or non-string values return 400 before any upstream call.

testNumbers
​string[]

Test numbers for which cost data is requested.

TestCost

Cost information for a single test number.
clientPrice
​string
clientDiscountedPrice
​string
patientPrice
​string
patientDiscountPrice
​string
labAccessPrice
​string
testNumber
​string
testName
​string

MultiTestCostResponse

Multi-test cost response. Successful (**2xx**) bodies are returned unchanged.
​TestCost[]

Cost rows for the requested test numbers.