Pharmacy Prescription Status Update

Fires when a prescription's status changes at the pharmacy (e.g. PROCESSING, SHIPPED, CANCELLED). The new status is carried in eventData.newStatus. The eventType is pharmacy_prescription_status_update.

Field guarantees

Field	Guarantee
`eventData.newStatus`	✅ Always present (v1)
`pharmacy_status` in v2	✅ Always present — `newStatus` aliases to `pharmacy_status` for this event type

v1 payload (legacy)

The full raw event document. targetEntity is the PrescriptionFulfillment; ownerEntity is the full patient document (contains PHI). The status is in eventData.newStatus.

{
  "ownerEntityModel": "Patient",
  "targetEntityModel": "PrescriptionFulfillment",
  "deleted": false,
  "ownerEntity": { "id": "pat::43e3b917-xxxx-xxxx-xxxx-70679b4a1b3f", "firstName": "<PATIENT_FIRST_NAME>", "lastName": "<PATIENT_LAST_NAME>", "email": "<PATIENT_EMAIL>", "…": "full patient document" },
  "targetEntity": {
    "pharmacyFulfillment": {
      "pharmacyStatus": "PROCESSING",
      "lastStatusReceived": "2023-06-12T20:15:00.000Z"
    },
    "status": "started",
    "prescription": "prescr::39538082-xxxx-xxxx-xxxx-ebea6e7a6c09",
    "order": "order::b6b288b5-xxxx-xxxx-xxxx-074dcdbfc4b2",
    "id": "prfm::8579e3c2-xxxx-xxxx-xxxx-424c82e68945"
  },
  "eventTitle": "The status of the prescription has changed at the pharmacy. The new status is PROCESSING",
  "eventDescription": "",
  "eventType": "pharmacy_prescription_status_update",
  "eventData": {
    "newStatus": "PROCESSING"
  },
  "createdAt": "2023-06-12T20:15:00.290Z",
  "updatedAt": "2023-06-12T20:15:00.290Z",
  "__v": 0,
  "id": "event::9c1d4e6f-xxxx-xxxx-xxxx-1a2b3c4d5e6f"
}

`eventData` field	Type	Always?	Notes
`newStatus`	string	✅	Pharmacy status, e.g. `PROCESSING`, `SHIPPED`, `CANCELLED`

v2 payload

Sanitized envelope. For this event type, newStatus maps to pharmacy_status (not order_status).

{
  "event_type": "pharmacy_prescription_status_update",
  "event_id": "event::9c1d4e6f-xxxx-xxxx-xxxx-1a2b3c4d5e6f",
  "api_version": "2026-08-09",
  "timestamp": "2026-05-30T14:00:00.000Z",
  "affiliate_id": "aff::c1636be3-xxxx-xxxx-xxxx-9dddc26e77b3",
  "patient_id": "pat::43e3b917-xxxx-xxxx-xxxx-70679b4a1b3f",
  "patient_external_id": "ext-patient-123",
  "patient_marketing_consent": false,
  "is_returning_patient": true,
  "order_id": "order::b6b288b5-xxxx-xxxx-xxxx-074dcdbfc4b2",
  "commerce_status": "started",
  "pharmacy_status": "PROCESSING"
}

Field	Delivered in v2	Notes
Envelope + patient identity	✅	Present on every v2 payload
`order_id`, `commerce_status`	✅	Resolved from the fulfillment's linked order
`pharmacy_status`	✅	The pharmacy status value from `eventData.newStatus`