API / Fulfilment & delivery
The terms attached to an offer: return window, who pays return shipping, restocking fees, warranty length and who honours it.
GET /v1/offers/{id}/returns
No parameters beyond the path and your bearer token.
GET /v1/offers/off_2c81/returns
→ 200
{ "returnable": true,
"window_days": 15,
"window_note": "30 days for members; 15 otherwise",
"return_shipping": "buyer_pays",
"restocking_fee_pct": 15,
"restocking_applies_to": ["opened_electronics"],
"warranty": { "months": 12, "honoured_by": "manufacturer" },
"source": { "channel": "verified_agent", "confidence": 0.9 } }A 15% restocking fee on a $200 item is $30 of risk, which can exceed the price difference an agent was optimising over. Ignoring return terms produces recommendations that are cheaper on paper and worse in practice.
Marketplace offers frequently carry different terms from the marketplace's own. The terms returned are for that offer, not for the site.