This endpoint is used to pull a list of returns that were created within a given timeframe, down to the second, and includes details about those returns.

We highly encourage using pagination for this endpoint.

Note: If no datetimes are passed, the response defaults to only contain returns from the previous 24 hours. See Query Params below for more information.

This endpoint supports pagination. Read the guide on paginating requests for details.


id: Loop's return id

order_id: Loop's order ID

order_name: Shopify order name

provider_order_id: Shopify order ID

order_number: Shopify order number

package_reference: The data used to lookup package data in WMS software.

return_method.scannable_id: The data used to scan and lookup return_method data in WMS software.

Click Try It! to start a request and see the response here!