Order Submission API
The Order Submission services let you build, validate, and submit Labcorp lab orders. Each service is reached at its own hostname through the gateway. The full endpoint reference, with request/response schemas, is in the Order Submission API reference.
Services
| Service | Host | Endpoints |
|---|---|---|
| Orders | orders.services.{env}.{domain} | POST /order, POST /validate |
| Outreach orders | outreach.services.{env}.{domain} | POST /order, POST /validate |
| On-demand orders | outreach-ondemand.services.{env}.{domain} | POST /order, POST /validate |
| Body site lookup | body-site.services.{env}.{domain} | GET /, GET /descriptors |
| Microbiology source lookup | microbiology.services.{env}.{domain} | GET / |
{env} is sandbox or certification for non-production, and is omitted for production.
{domain} defaults to aperture.labcorp.com.
What you can do
- Validate an order without submitting it, then submit it and receive the Labcorp requisition PDF and barcode in the response.
- Receive an Advance Beneficiary Notice (ABN) automatically when the order needs one.
- Attach ask-at-order-entry (AOE) and microbiology source data.
- Look up body site, descriptor, and microbiology source codes.
Get started
- Authenticate to the gateway. All services are called with your bearer token; you do not authenticate to an individual service directly.
- Follow the Orders workflow for the validate and submit lifecycle.
- Explore every endpoint in the Order Submission API reference.
Guides
- Orders workflow: validate and submit an order, read the response, handle errors.
- AOE workflow: ask-at-order-entry questions for specialty test types, including microbiology source and histology/pathology body site.
- Resources: downloadable reference materials.
Last modified on