Get return shipment details
returnRequestId returned from Create return shipment.
A return shipment represents a parcel before warehouse receipt. Once the warehouse logs the parcel it becomes a return inventory item; from that point use Get return inventory details, which carries the post-receipt handling data.
Recovering a missed label
The label is atshipments[].label.labelUrl. The main use for this endpoint is reconciliation after a system incident: if your receiver missed a label notification, call it with the returnRequestId to read the current labelUrl and trackingNumber directly. An empty labelUrl means generation has not finished (or failed) — check shipments[].label.labelRequestStatusCode.
Authorizations
Your API key
Your API token — keep this private
Query Parameters
Return request identifier, as returned by Create return shipment.
Response
Success
Full record of a return shipment. Successful responses also carry the standard envelope fields (correlationId, meta) alongside the fields below.
Return request identifier
Return request number
Your merchant-supplied reference, echoed back for reconciliation
Current return status code
Return title
Declared total value of the return
ISO 4217 currency code of totalValue (e.g. USD)
Warehouse-assigned RMA reference (uppercased). Populated once the warehouse processes the parcel.
Free-text remarks
Whether the return request is archived
Origin/source of the return request
Shipments belonging to this return request, each with its label.
Line items included in the return request.
Return inventory records derived from this request, populated once the warehouse has received the parcel. Empty before receipt — use Get return inventory details for full inventory data at that stage.
Custom fields attached to the return shipment.