Authorizations
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Path Parameters
The unique return ID. This ID is automatically generated when a return is approved.
The unique RMA ID. This ID is automatically generated when a merchant registers a pending return for a supplier using the POST /v1/retailers/{retailer_id}/rmas/
endpoint.
The unique brand ID. In the Dropship UI this is called the Supplier ID. To find your Supplier ID, click your supplier name in the top nav.
Body
A description of the return.
128
"Customer is returning item due to wrong size."
The quantity of items being returned.
0 <= x <= 4294967295
1
The weight of the return shipment.
2.5
The width of the return package.
10
The length of the return package.
15
The height of the return package.
5
Specifies signature requirements for the delivery.
required
, not_required
, adult
"not_required"
The tracking number for the return shipment.
128
9.4001e+21
A reference identifier for the shipping label.
30
"LBLREFXYZ123"
An identifier from the shipping provider.
64
"USPS-PKG-001"
The current status of the return.
pending
, received
, approved
, rejected
"pending"
Notes recorded during the inspection of the returned items.
"Item received in good condition, no visible defects."
The desired file format for the shipping label.
PNG
, PDF
"PDF"
The amount charged for shipping the return.
"8.75"
The tariff code for customs purposes, if applicable.
16
"9801.00.10"
The declared value of the returned goods.
"75.99"
Response
Ok
Represents a single return within an RMA, detailing shipping information, status, and associated data.
The unique identifier of the return.
197
The shipping carrier used for the return.
"UPS"
The shipping account used for the return.
"1A2B3C4D"
The shipping method used for the return.
"Ground"
The destination address for the return.
"123 Return Ave, Anytown, USA"
A description of the return.
128
"Customer returned damaged item."
The quantity of items being returned.
0 <= x <= 4294967295
1
The weight of the return shipment.
2.5
The width of the return package.
10
The length of the return package.
15
The height of the return package.
5
Specifies signature requirements for the delivery.
required
, not_required
, adult
"not_required"
The tracking number for the return shipment.
128
9.4001e+21
A reference identifier for the shipping label.
30
"LBLREF1234567890"
An identifier from the shipping provider.
64
"SPID987654321"
The current status of the return.
pending
, received
, approved
, rejected
"pending"
Notes recorded during the inspection of the returned items.
"Minor scuff marks on the left side."
Consolidated tracking information for the return.
"https://www.ups.com/track?tracknum=9400100000000000000000"
The file format of the shipping label.
PNG
, PDF
"PDF"
The amount charged for shipping the return.
"12.50"
The tariff code for customs purposes, if applicable.
16
"9801.00.1010"
The declared value of the returned goods.
"150.00"
Logs of any errors encountered during the return process.
"No errors logged."
The timestamp when the return record was created.
"2023-01-15T09:30:00.000Z"
The timestamp when the return was physically received.
"2023-01-20T10:00:00.000Z"
The timestamp when the return was approved.
"2023-01-21T11:00:00.000Z"
The timestamp when the return was rejected.
"2023-01-21T11:15:00.000Z"