v2

latestOpenAPI 3.1.12026-08-078549932.4 MB
MedicationRequests

Capture a request (front desk, Inventory permission). Nothing billable is created; the request lands in the provider's approve queue. OTC items auto-approve and rest at Approved until pickup.

post/medication-requests

Request body

patientIdstring
inventoryItemIdstring nullable

The requested med, when the capturer could identify it.

freeTextMedicationstring nullable

"She called it the white pills" — must be resolved before approval.

notesstring nullable
sourcestring nullable

staff | phone | client-app. Defaults to phone (the multi-day lane's main source).

fulfillmentMethodstring nullable

Suggested fulfillment; the approving provider decides.

renewalOfPrescriptionIdstring nullable

Prior Rx this request renews, when captured from medication history (Phase 3 UI).

suggestedProviderIdstring nullable
suggestedDosagestring nullable
suggestedFrequencystring nullable
suggestedDurationstring nullable
suggestedInstructionsstring nullable

Response

Created

idstring
patientIdstring
patientNamestring nullable
clientIdstring nullable
inventoryItemIdstring nullable
medicationNamestring nullable
freeTextMedicationstring nullable
notesstring nullable
sourcestring
isOtcboolean
fulfillmentMethodstring nullable
statusstring
billingStatestring

Derived: none | quoted | quote_removed | unbilled | invoiced | paid. "unbilled" is the "Ready to bill" worklist predicate.

requestedByIdstring nullable
requestedByNamestring nullable
requestedAtstring date-time
approvedByIdstring nullable
approvedByNamestring nullable
approvedAtstring date-time nullable
deniedByIdstring nullable
deniedAtstring date-time nullable
denialReasonstring nullable
cancelledByIdstring nullable
cancelledAtstring date-time nullable
cancelReasonstring nullable
dispensedAtstring date-time nullable
prescriptionIdstring nullable
prescriptionItemIdstring nullable
estimateIdstring nullable
estimateLineItemIdstring nullable
invoiceIdstring nullable
renewalOfPrescriptionIdstring nullable
suggestedProviderIdstring nullable
suggestedDosagestring nullable
suggestedFrequencystring nullable
suggestedDurationstring nullable
suggestedInstructionsstring nullable
createdAtstring date-time
updatedAtstring date-time