Specimen Management API
Specimen Management API
Specimen Management API for Labcorp specimen pickup: look up pickup locations for an account and schedule a pickup. Every call requires sendingFacility and sendingApplication, which this service matches to an ACTIVE client config before authorizing the account and fulfilling the request.
Authentication
OAuth2 client credentials flow. Present a bearer access token obtained from the Labcorp token endpoint; no scope is required on the token.
Response Codes
| Code | Meaning |
|---|---|
| 200 | Successful response. |
| 400 | Request validation failed (for example missing sendingFacility / sendingApplication, missing schedule fields, or outside the cutoff window). |
| 401 | Authentication failed — the bearer token is missing or invalid. |
| 403 | The requesting partner is not authorized, including client-config-not-authorized and partner-not-owner. |
| 404 | Account or locations not found, including locations-not-found, not-found, and data-incomplete. |
| 500 | Internal error. Includes structured subscription-config-incomplete / subscription-config-ambiguous, and opaque failures from dependency HTTP 400–500. |
| 502 | Downstream dependency unavailable or dependency HTTP 501+. |