get
https://api.ecartapi.com/api/v2/orders//returns
Retrieves all after-sales (returns) linked to a specific order.
orderId is required (Temu's parentOrderSn, e.g. PO-211-08965103913592338).
Time Range Filter
Temu requires at least one time range parameter. If no filters are passed, ecartAPI automatically defaults to the last 90 days.
status filter values
status filter valuesTemu groups statuses internally. Pass the group number as status:
status | Group |
|---|---|
| 1 | Pending |
| 2 | Requested |
| 3 | Package Shipped |
| 4 | Platform Reviewing |
| 5 | Refunded |
| 6 | Rejected |
| 7 | Cancelled |
Response fields
| Field | Description |
|---|---|
available | "true" if upload label is available (availableOperateList includes 10), "false" otherwise |
type | Return delivery type: dropOff or pickUp. null if not determined |
Note on returnItems
The list endpoint returns returns without item detail. Use Get single return to retrieve returnItems with productId, variantId, sku, and name.