v2

latestOpenAPI 3.1.12026-08-078549932.4 MB
MedicationRequests

Approve (provider with Dispense permission + the primary-provider flag). For Rx this authors the Prescription, routes it, and creates the request's own quote estimate with its Pending line (one estimate per request).

post/medication-requests/{id}/approve

Path parameters

idstring required

Request body

useRefillboolean nullable

Renewal approval mode (design §7). True = "use a refill": increments RefillsUsed on the prior Rx and reuses it — no new legal record, no SIG. False/absent on a renewal = "new prescription" (the normal create path, keeping the renewal link). 409 when the prior Rx is inactive, expired, exhausted, or DEA Schedule II.

providerIdstring nullable

Prescribing DVM. Defaults to the approving caller.

inventoryItemIdstring nullable

Resolves a free-text capture to a real item (required if capture had none).

fulfillmentMethodstring nullable
pharmacyIdstring nullable
dosagestring nullable
frequencystring nullable
durationstring nullable
instructionsstring nullable

SIG — required for Rx approval.

medicationCategorystring nullable
notesstring nullable
estimateIdstring nullable

Escape hatch from one-estimate-per-request: put the billable line on this existing live estimate instead of a fresh standalone draft (e.g. adding a med to an estimate about to be presented, or the visit's estimate).

isCascadeboolean nullable
cascadeReasonstring nullable
antimicrobialUseTypestring nullable
antimicrobialJustificationstring nullable
clinicalAssessmentPerformedboolean nullable
physicalExamPerformedboolean nullable
physicalExamJustificationstring nullable
withdrawalPeriodstring nullable

Response

OK

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