Lab Order Sent To Lab

Fires when a lab order is transmitted to the lab for testing. targetEntity is the LabOrder. The eventType is lab_order_sent_to_lab.

Field guarantees

Field	Guarantee
`eventData` (v1)	⚠️ Conditional — the Junction integration attaches `labOrderId`/`labStatus`/`labName`/`timestamp`; the SpotLab path sends no `eventData`
v2 lab reference (`lab_order_id`, `lab_order_status`)	✅ Always present

🚧
eventData depends on the lab integration. Don't rely on any eventData field for this event — the SpotLab path omits it entirely. Use the lab-order reference (present in both v1's entity data and v2).

v1 payload (legacy)

Example from the SpotLab path — no eventData. ownerEntity/targetEntity are the full patient/lab-order documents; abbreviated here.

{
  "ownerEntityModel": "Patient",
  "targetEntityModel": "LabOrder",
  "deleted": false,
  "ownerEntity": { "id": "pat::50c75435-xxxx-xxxx-xxxx-25220febd9cf", "firstName": "<PATIENT_FIRST_NAME>", "lastName": "<PATIENT_LAST_NAME>", "…": "full patient document" },
  "targetEntity": { "id": "lbo::3293cd49-xxxx-xxxx-xxxx-c8bb185b979a", "status": "pending", "lab": "lab::f9cf4d46-xxxx-xxxx-xxxx-e1a313b385c6", "…": "full lab order" },
  "eventTitle": "Lab Order Sent To Lab For Testing",
  "eventDescription": "Lab order data record was sent.",
  "eventType": "lab_order_sent_to_lab",
  "_id": "event::629338c2-xxxx-xxxx-xxxx-1c09c23a7178",
  "createdAt": "2025-06-19T16:26:08.072Z",
  "updatedAt": "2025-06-19T16:26:08.072Z",
  "id": "event::629338c2-xxxx-xxxx-xxxx-1c09c23a7178"
}

The Junction integration path additionally sets eventData with labOrderId, labStatus, labName, and timestamp — treat all as optional.

v2 payload

Sanitized envelope. lab_order_id/lab_order_status resolve from the lab order.

{
  "event_type": "lab_order_sent_to_lab",
  "event_id": "event::629338c2-xxxx-xxxx-xxxx-1c09c23a7178",
  "api_version": "2026-08-09",
  "timestamp": "2026-05-30T14:00:00.000Z",
  "affiliate_id": "aff::81fdb635-xxxx-xxxx-xxxx-c06828373d7d",
  "patient_id": "pat::50c75435-xxxx-xxxx-xxxx-25220febd9cf",
  "patient_external_id": "ext-patient-123",
  "patient_marketing_consent": false,
  "is_returning_patient": false,
  "lab_order_id": "lbo::3293cd49-xxxx-xxxx-xxxx-c8bb185b979a",
  "lab_order_status": "pending"
}

Field	Delivered in v2	Notes
Envelope + patient identity	✅
`lab_order_id`, `lab_order_status`	✅	Resolved from the lab order

📘
Completing the loop on v2. Full lab-order detail — the external requisition id (labOrderId), lab name, results, and a status history with dates — is retrievable via GET /labOrders/:id using the delivered lab_order_id. The endpoint is scoped to your affiliate.