Skip to content

Get a lab order

Request

Retrieve a single lab order by its numeric id.

Security
PartnerApiKey and PartnerOAuth
Path
labOrderIdinteger, (int64)required

Lab order id

Example:9001
accountIdinteger, (int64)required

Account identifier

locationIdinteger, (int64)required

Location identifier

curl -i -X GET \
  'https://api-docs.lobbie.com/_mock/openapi/partner/v2/account/{accountId}/location/{locationId}/lab-order/9001' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'x-api-key: YOUR_API_KEY_HERE'

Responses

Lab order retrieved successfully

Bodyapplication/json
createdAtstring, (date-time)

Creation timestamp (UTC)

Example:"2025-01-15T14:00:00Z"
idinteger, (int64)

Lab order id

Example:9001
labIdinteger, (int64)

Id of the linked /lab record, so a partner can navigate to the existing lab read view

Example:12345
locationIdinteger, (int64)

Location id

Example:200
orderNumberstring

The account's order reference number

Example:"ORD-100245"
orderingProviderIdinteger, (int64)

Ordering provider (staff) id (resolve via /staff)

Example:412
patientIdinteger, (int64)

Patient id (resolve via /patient)

Example:300
statusstring

Lifecycle status of a lab order, from staff placement through partner fulfilment. The server owns every transition; the partner never sets the status directly. SUBMITTED: placed by staff and awaiting partner pickup. ACCEPTED: the partner acknowledged the order and recorded its thirdPartyLabId. REJECTED: the partner declined the order; terminal, staff correct and re-release as a new order. PARTIALLY_RESULTED: some ordered tests have results, others are still pending. RESULTED: every ordered test has a final result. CORRECTED: a previously delivered result was superseded by a correction. CANCELLED: the order was cancelled before fulfilment.

Enum:"SUBMITTED""ACCEPTED""REJECTED""PARTIALLY_RESULTED""RESULTED""CORRECTED""CANCELLED"
Example:"SUBMITTED"
testsArray of objects(LabOrderTestDTO)

Ordered tests with their Ask-on-Entry answers

thirdPartyLabIdstring

Lab-assigned order identifier (accession / requisition number); null until the order is accepted

Example:"ACC-8837162"
updatedAtstring, (date-time)

Last update timestamp (UTC)

Example:"2025-01-15T14:00:00Z"
Response
{
  "createdAt": "2025-01-15T14:00:00Z",
  "id": 9001,
  "labId": 12345,
  "locationId": 200,
  "orderNumber": "ORD-100245",
  "orderingProviderId": 412,
  "patientId": 300,
  "status": "SUBMITTED",
  "tests": [
    { … }
  ],
  "thirdPartyLabId": "ACC-8837162",
  "updatedAt": "2025-01-15T14:00:00Z"
}