How can I have visibility on all customer return requests and incoming returns?
Option 1: API
You can retrieve all customer return requests via API using the dedicated returns endpoint.
→ More information here: Cancellations and Returns
- Call the
ListOrderItemReturnsendpoint. - This endpoint replaces the previous
is_return_initiatedfilter inListOrders. - The response provides full visibility over return requests and incoming returns, including:
- Order and order item IDs
- Order item identifiers (e.g. IMEI or serial number, when available)
- Return request details (request date and return reason)
- Return status and trial-period eligibility
- Return tracking information, so you can follow the shipment status
- Delivery date and time once the parcel arrives at your warehouse (based on carrier tracking updates)
- Direct link to the related Zendesk ticket
This allows you to monitor return requests, track incoming parcels, and access the related customer communication from your own systems.