Test Code Information

Server

Search test codes and retrieve multi-test cost data.

Search the test-info grid.

POST

https://testinfo-service.services.{domain}

/v2/grid/search

Search Labcorp test code information using the test-info grid (v2).

sendingFacility, sendingApplication, and accountNumber are required in the JSON body. Identity fields are matched to an active partner client configuration and stripped before the upstream call. Missing, blank, whitespace-only, or non-string values for required fields return 400 with a structured ValidationIssue envelope before any upstream call. Other request fields follow the published request contract and are forwarded unchanged.

Successful (2xx) JSON from upstream is returned unchanged.

Search the test-info grid. › Request Body

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

TestInfoGridRequestV2

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.

Search the test-info grid. › Responses

The grid search completed. The JSON body matches the upstream response.

Grid search response. Successful (**2xx**) bodies are returned unchanged.

TestInfoGridResponse

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.

POST/v2/grid/search

curl 'https://testinfo-service.services.{domain}/v2/grid/search' \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "accountNumber": "12345678",
  "sendingFacility": "LC001",
  "sendingApplication": "PARTNER_APP",
  "identifierType": "KEYWORD",
  "identifierValue": "CBC",
  "expandedSearch": true,
  "orderable": true
}'

Example Request Body

{
  "accountNumber": "12345678",
  "sendingFacility": "LC001",
  "sendingApplication": "PARTNER_APP",
  "identifierType": "KEYWORD",
  "identifierValue": "CBC",
  "expandedSearch": true,
  "orderable": true
}

json

application/json

Example Responses

{
  "totalRecordCount": 1,
  "totalOrderableRecordCount": 1,
  "testInfoResults": [
    {
      "testNumber": "001234",
      "testName": "Complete Blood Count",
      "publishedCode": "CBC",
      "orderable": true,
      "published": true,
      "specimenType": "Whole Blood",
      "tat": "1 day"
    }
  ]
}

json

application/json

Retrieve multi-test cost data.

POST

https://testinfo-service.services.{domain}

/multitestcost

Retrieve cost information for one or more test numbers for a partner account.

sendingFacility, sendingApplication, and accountNumber are required in the JSON body. Identity fields are matched to an active partner client configuration and stripped before the upstream call. Missing, blank, whitespace-only, or non-string values for required fields return 400 with a structured ValidationIssue envelope before any upstream call. testNumbers and any other body fields follow the published request contract and are forwarded unchanged.

Successful (2xx) JSON from upstream is returned unchanged.

Retrieve multi-test cost data. › Request Body

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.

MultiTestCostRequest

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.

Retrieve multi-test cost data. › Responses

Cost data was returned. The JSON body matches the upstream response.

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

MultiTestCostResponse

TestCost[]

Cost rows for the requested test numbers.

POST/multitestcost

curl 'https://testinfo-service.services.{domain}/multitestcost' \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "accountNumber": "12345678",
  "sendingFacility": "LC001",
  "sendingApplication": "PARTNER_APP",
  "testNumbers": [
    "001234",
    "005678"
  ]
}'

Example Request Body

{
  "accountNumber": "12345678",
  "sendingFacility": "LC001",
  "sendingApplication": "PARTNER_APP",
  "testNumbers": [
    "001234",
    "005678"
  ]
}

json

application/json

Example Responses

{
  "multiTestCost": [
    {
      "testNumber": "001234",
      "testName": "Complete Blood Count",
      "clientPrice": "12.50",
      "patientPrice": "45.00"
    },
    {
      "testNumber": "005678",
      "testName": "Basic Metabolic Panel",
      "clientPrice": "8.25",
      "patientPrice": "30.00"
    }
  ]
}

json

application/json

Overview