Skip to main content
Which endpoint you use depends on whether the order has been physically picked. Not yet picked — PUT /api/v1/orders/{order_id}/cancel cancels it immediately. Valid from received, paused, or exception. Already picked or verified — PUT /api/v1/orders/{order_id}/request_cancellation raises a request for pharmacy staff. It does not change the order’s status.

​
Requesting cancellation on a picked order

The reason is optional but genuinely useful — it reaches the staff member who handles the request.
Request cancellation does not cancel the order. It sets cancellation_requested: true and leaves the status alone. Don’t treat a successful response as confirmation the order is dead — poll the order or subscribe to a webhook to see the real outcome.
Only one cancellation request per order is allowed. A second call is rejected. If circumstances change, contact Blend support rather than re-requesting.

​
Why picked orders work differently

Once an order has been picked, its contents are physically off the shelf and inventory has already been decremented. Blend does not mark the order cancelled until staff have unpicked the products and returned them to stock, so that inventory stays accurate. The request is picked up at pharmacist verification or at shipping, the products are returned, and the order is then cancelled.

​
Deciding which to call

Check the current status first with GET /orders/{order_id}, or simply attempt /cancel and fall back to /request_cancellation on rejection.
An order that has already shipped cannot be cancelled. If the shipment was wrong, request a replacement instead.
Cancelling an order does not cancel the underlying prescription. The prescription keeps its remaining fills and can be ordered against again. If Blend auto-creates your orders from prescriptions, a cancelled order may simply regenerate unless the prescription is dealt with too — see editing an order.
Both actions are available on the order page in the Blend Dashboard, which is where most customer-service cancellations happen.

Cancel an order

received, paused, exception

Request cancellation

picked, verified

Pause an order

Hold instead of cancel

Get an order's status history

Confirm what actually happened