Shopify Get Returns
Retrieves all returns associated with a Shopify order using the Shopify GraphQL Admin API. Provide an order ID and the action returns detailed information for each return, including:
- Return status — current state of the return (
OPEN,CLOSED, etc.) along with created and closed timestamps. - Return line items — each item being returned with quantities (processable, processed, refundable, refunded), SKU, variant details, and customer/reason notes.
- Exchange line items — any items exchanged as part of the return.
- Refunds — refund records linked to the return.
- Reverse deliveries — shipping details for the return including carrier name, tracking number, tracking URL, label URL, and per-item delivery line items.
- Decline info — decline details if the return was declined.
Inputs
| Name | Type | Description |
|---|---|---|
| Order ID | String | Shopify order ID |
Outputs
| Name | Type | Description |
|---|---|---|
| Success | Boolean | Whether the order was found and has returns |
| Returns | Object | Array of return details |
| Number of Returns | Number | Total number of returns found |
| Shopify Errors | Object | GraphQL errors returned by Shopify (if any) |
| Error | String | Error message when found is false or on invalid input |
| Hint | String | Hint for the error |
Updated about 22 hours ago