Return

Return object model

id
string
required

UUID without dashes in between

rma_number
string
required

Short id for return. It will be unique most of the time within a single store. It's for store customers to identify their returns.

Example:
EUGCX4FL
status
string
required

RMA status mainly refelected the approval status of a return, NOT for logistics status of shipments of return items.Show all...

Allowed values:
submittedapprovedshippedreceivedrejecteddoneexpired
internal_notes
string
required
Example:
Please call him to confirm before sending the refund.
order
Order
required
id
string
required

UUID without dashes in between

order_number
string
required

The order number that a customer inputs on the returns page.

Example:
1005
customer_name
string
required
Example:
James Law
customer_email
string<email>
required
country
string
required

ISO_3166-1 Country Code in 3 letters

>= 3 characters<= 3 characters
Example:
USA
external_id
string

Order id in the eCommerce platform. E.g., Shopify order id

Example:
77
app
PlatformApp

app model

return_items
array[ReturnItem]
required
external_id
string
required
external_product_id
string
required
title
string
required
sku
string
required
ordered_quantity
integer
required
return_quantity
integer
required
price
Price
required

(Deprecated) The field was still maintained only for some legacy customers. Please do not depend on this value. For price, discount, tax, and other order data, please directly connect to order data source. AfterShip Returns does not own and maintain order data, but only returns data.

image_url
string<uri>
required

(Deprecated) The field was still maintained only for some legacy customers. Please do not depend on this value. For product data, please directly connect to product data source. AfterShip Returns does not own and maintain product data, but only returns data.

Example:
https://example..com/cool-stuff.jpg
exchange_variant
ExchangeVariant or null
return_reason
ReturnReason
subreason
string
Example:
cover is broken
merchant_tags
array[object]
bundled_items
array[object]

If current item is a bundle, this field includes its inner items.

last_received_at
string or null
<date-time>

The moment when the item was marked as received last time.

received_quantity
number
return_images
array[object]

Item image uploaded with its return reason.

resolution
Resolution
required

Types of resolutions:Show all...

type
string
required
Allowed values:
store_creditoriginal_paymentexchangeexchange_for_anythingrefundid
exchange_notes
null or string
required

Only present when the resolution is exchange

Example:
Please ship to me with a new gift box
return_method
ReturnMethod
required
type
string
required
Allowed values:
retailer_labelcustomer_courierin_store
cost_of_return
CostOfReturn
required
label
Label
required
name
string
required

Return method name

zone
object
rule
object
created_at
string<date-time>

The moment when a customer successfully submits a return request.

updated_at
string<date-time>
tracking_number
string
required

The tracking number of the return shipment provided by the customer / merchant.

reject_reason
string
required
shipments
array[object]
tracking_number
string
tracking_status
string

This field will be null if you don't have a valid AfterShip Tracking subscription. Follow https://www.aftership.com/docs/tracking/enum/delivery-statuses for enum options.

items
array[object]
label
Label
dropoffs
array[object]
qr_code
string

The url of QR code

dropoff_number
string

The unique identifier issued by dropoff providers

slug
Allowed value:
happy-returns
created_at
string
status
Allowed values:
createdcreatingdroppedfailedpartially_dropped
items
array[object]
shipments
array[object]
exchange_order
object
id
string
order_number
string
customer_name
string
customer_email
string
country
string
external_id
string
app
object
Example
preparing...