v2

latestOpenAPI 3.1.12026-08-078549932.4 MB
MedicationRequests

Dispense an Approved request from inventory at pickup (Dispense permission). Runs the shared dispense engine and fulfills the request's own Pending line; works for both Rx and phoned-in OTC requests.

post/medication-requests/{id}/dispense

Path parameters

idstring required

Request body

lotIdstring nullable
locationIdstring nullable
witnessUserIdstring nullable

Witness for controlled-substance dispenses. Required by the dispense engine (non-overridable) whenever the item has a DEA book.

containerIdstring nullable

Physical container to draw from (controlled items, ITE-157).

notesstring nullable
collectorNamestring nullable
collectorIdCheckedboolean nullable

Response

OK

successboolean
prescriptionIdstring nullable
transactionIdstring nullable
patientIdstring
messagestring
invoiceLineItemIdstring nullable

Populated when the request supplied string? CreateMedicationRequestDto.InvoiceId and an estimate line item was created in the same call.

invoiceIdstring nullable

The estimate the dispense was attached to — either the one the caller supplied or one auto-created/resolved server-side. Lets a client that had no estimate of its own adopt the server's estimate instead of failing to reconcile the line.

estimateIdstring nullable

The estimate the request's billable line was placed on at creation (in-house / same-day requests). Null for external (non-billable) requests.

estimateLineItemIdstring nullable

The Pending estimate line created for this request at creation, if any.

medicationRequestIdstring nullable

The lifecycle MedicationRequest recorded for this operation. The compound endpoint applies capture → approve → dispense as far as the caller's permissions allow; string? MedicationRequestResultDto.RequestStatus says where it stopped.

requestStatusstring nullable

Lifecycle status after this call: requested | approved | dispensed.