curl --request POST \
--url https://api.returnshelper.com/uat/user/api/ReturnShipment/createReturnShipment \
--header 'Content-Type: application/json' \
--header 'x-rr-apikey: <api-key>' \
--header 'x-rr-apitoken: <api-key>' \
--data '
{
"serviceTypeCode": "fedex_ground",
"orderTitle": "Return Label Title",
"orderNumber": "123123",
"totalValueCurrency": "usd",
"shipment": {
"shipToWarehouseId": 2,
"boxType": "cus",
"sellerReferenceNumber": "<string>",
"shipFrom": {
"country": "usa",
"contactName": "Your name",
"phone": "15622708183",
"email": "user@example.com",
"fax": "<string>",
"street1": "Some address line 1",
"street2": "Some address line 2",
"street3": "<string>",
"state": "tx",
"city": "Houston",
"postalCode": "77235"
},
"parcel": {
"weight": 10.5,
"weightUnit": "g",
"length": 10,
"width": 10,
"height": 10,
"dimensionUnit": "cm",
"items": [
{
"description": "Test item",
"weight": 10.5,
"value": 100,
"weightUom": "g",
"valueCurrencyCode": "usd"
}
]
},
"customFieldMap": {}
},
"totalValue": 100,
"sellerReferenceNumber": "<string>",
"remarks": "<string>"
}
'curl --request POST \
--url https://api.returnshelper.com/uat/user/api/ReturnShipment/createReturnShipment \
--header 'Content-Type: application/json' \
--header 'x-rr-apikey: <api-key>' \
--header 'x-rr-apitoken: <api-key>' \
--data '
{
"serviceTypeCode": "fedex_ground",
"orderTitle": "Return Label Title",
"orderNumber": "123123",
"totalValueCurrency": "usd",
"shipment": {
"shipToWarehouseId": 2,
"boxType": "cus",
"sellerReferenceNumber": "<string>",
"shipFrom": {
"country": "usa",
"contactName": "Your name",
"phone": "15622708183",
"email": "user@example.com",
"fax": "<string>",
"street1": "Some address line 1",
"street2": "Some address line 2",
"street3": "<string>",
"state": "tx",
"city": "Houston",
"postalCode": "77235"
},
"parcel": {
"weight": 10.5,
"weightUnit": "g",
"length": 10,
"width": 10,
"height": 10,
"dimensionUnit": "cm",
"items": [
{
"description": "Test item",
"weight": 10.5,
"value": 100,
"weightUom": "g",
"valueCurrencyCode": "usd"
}
]
},
"customFieldMap": {}
},
"totalValue": 100,
"sellerReferenceNumber": "<string>",
"remarks": "<string>"
}
'Your API key
Your API token — keep this private
Return service type code
Order title / return title
Order number
Currency code for totalValue (e.g. USD)
Shipment details including origin address and parcel info
Show child attributes
Total declared value of the return
Seller reference number
Additional remarks
Success