Commerce CensusContactRequest access

API / Fulfilment & delivery

Returns & warranty

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

Request

No parameters beyond the path and your bearer token.

Request & response
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 } }

Notes

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.