Ability to get Return Information via the API

Shopify Partner
4 0 1



I know this question has been asked in various forms but was wondering if there is any update on being able to retrieve the return information from Shopify via the API.  We seem to have full access to the refund data set but not the return one.




If I initiate a return using the return items in the admin I'm able to select the items to return, select a return reason and start the return process.


A webhook is generated saying that the order has been changed but there is no way to actually query that return information through the API.  I can see that the Shopify application is querying new data sets that are not available in the API (returns).  The only way I can know that a return has been initiated is by looking at the events for the order




You created a return #1223-R1 for this order.


or something similar will appear when you query the events for the order.


Until a refund is done for the return there is no way to know what items are being returned.  Additionally, there is no way to get the actual return reason that was set when the return was initiated.


Are there plans to add this to the API?

Building the next generation of startups.
Replies 2 (2)

Shopify Partner
9 0 1

what you describe is very clear🤣,I also found that what about return order information can get is only event msg,detail about item or return reason is no way,I lost day and day to find a solution but has no result

1、Order API:get nothing about return

2、Refund API:when order status is return in process,has no refund

3、Event API:only get a less information tell that order has a return,but has no return detail

4、GraphQL API:just a different way get same thing as Rest API



2 0 1

Bumping this post because we are looking for this data to be available. Thank you!