Draft Order "Reserve Items"

New Member
2 0 2

I see functionality was added in the Shopify admin that provides the ability to reserve the items in a draft order until a specific date. It looks like you're passing a property not outlined in the API docs like this: 

"reserve_items_until": "2020-01-31T14:00:00.000Z"

Can app developers use this param to similar effect, or is this locked down for Shopify internal use only?


If not, reserving inventory via the API would be a tremendous help in our use case, so I'd love to see this opened up to all developers.

Shopify Staff (Retired)
Shopify Staff (Retired)
623 104 146

This is an accepted solution.

Hey @SteveKemper ,


The "reserve_inventory_until" field of Draft Orders is only available internally when creating Draft Orders through the Shopify Admin UI. You unfortunately cannot create a new Draft Order with this field through any of the Shopify API.


As far as I know, there are no plans for taking this field from internal use only to public use anytime soon. However you can keep an eye out on the Shopify Changelogs (https://changelog.shopify.com/ and https://developers.shopify.com/changelog) to see if this feature ever gets added. 


Hassain | Developer Support Specialist @ Shopify
 - Was my reply helpful? Click Like to let me know! 
 - Was your question answered? Click Accept as Solution 

Shopify Partner
4 0 5

I think this field is necessary to make the Draft Order API usefull. Most use cases will need to hold inventory, thats the whole point of a draft order. Any news on this topic?

26 0 12

I'd like to be able to put a 'Reserve' sign on products that I've reserved through a draft order. If the field is only accessed internally, does that mean I can't use it to add the 'Reserved' image? I'm not so tecchy, but would love to be able to do this. Thanks

New Member
1 0 7

@hassain @Shopify could you please consider adding the reserve items option to the draft order API? We have an app that manages our returns/exchanges, when a customer requests an exchange we need the items to be reserved for that customer. 

4 0 3

I dont understand... so is there a report or somewhere we can see the 'reserved' stock totals???