Skip to main content
A replacement is a genuinely new order — its own order number, its own lifecycle — with two differences from an ordinary one: it carries a link back to the order it replaces, and it does not decrement fills on the underlying prescription. A patient whose shipment arrived damaged doesn’t lose a refill because of it.
The reason reaches the pharmacy staff who fulfil the request, so make it specific — “damaged in transit, vial cracked” is more actionable than “problem”.

​
Tracking the request

The order object carries the full replacement picture:

​
Finding the replacement order

Once created, the replacement is visible immediately — you don’t need to wait for anyone to send you the number. Poll the original order and read replacement_order_ids, or find it in the Blend Dashboard on the orders list, filtered to your account. It also appears on the patient’s order history.
Approvals and declines are recorded as comments on the replacement thread, and anyone who has previously commented on that thread is notified by email. If a request is declined, the reason reaches the requester through that channel.

​
What a replacement doesn’t do

A replacement also doesn’t cancel or reverse the original order. The original keeps its own status and history; the two are linked, not merged.

​
Replacement, cancellation, or a new order?

  • Shipment was wrong or damaged, patient should not lose a fill → replacement
  • Order shouldn’t ship at all and hasn’t been picked → cancel
  • Order shouldn’t ship yet → pause
  • Patient wants more product and has fills remaining → an ordinary new order

Replace an order

PUT /orders/order_id/request_replacement

Get an order's details

Read replacement_request_status

Get orders

Find replacements across your account

Request cancellation

When it shouldn’t ship instead