Skip to main content
POST
Approve a return + choose resolution

Authorizations

Authorization
string
header
required

API key as a bearer token. Secret keys (sk_) allow writes; publishable keys (pk_) are read-only. live = production, test = sandbox.

Path Parameters

returnId
string<uuid>
required

Body

application/json
resolution
enum<string>
required

How a return is settled. exchange ships a replacement (no refund); refund refunds the customer and claws back the liable party's settled cut; repair/store_credit move no courier money; reject declines it.

Available options:
refund,
exchange,
repair,
store_credit,
reject
merchant_note
string

Response

Approved — reverse shipment created.

return_id
string
status
string
Example:

"approved"

reverse_shipment_id
string