Skip to main content
object

Requires read_returns access scope or read_marketplace_returns access scope.

An item that a customer returns from a fulfilled order. Links to the original FulfillmentLineItem and tracks quantities through the return process.

The line item includes the customer's reason for returning the item and any additional notes. It also tracks processing status with separate quantities for items that are processable, processed, refundable, and refunded. You can apply optional restocking fees to cover handling costs.

Learn more about creating a return.

•String

A note from the customer that describes the item to be returned. Maximum length: 300 characters.

•FulfillmentLineItem!
non-null

The fulfillment line item from which items are returned.

•ID!
non-null

A globally-unique ID.

•Int!
non-null

The quantity that can be processed.

•Int!
non-null

The quantity that has been processed.

•Int!
non-null

The quantity being returned.

•Int!
non-null

The quantity that can be refunded.

•Int!
non-null

The quantity that was refunded.

•RestockingFee

The restocking fee for the return line item.

Anchor to returnReasonDefinitionreturnReasonDefinition
•ReturnReasonDefinition

The standardized reason for why the item is being returned.

•String!
non-null

Additional information about the reason for the return. Maximum length: 255 characters.

•Weight

The total weight of the item.

•Int!
non-null

The quantity that has't been processed.

Anchor to withCodeDiscountedTotalPriceSetwithCodeDiscountedTotalPriceSet
•MoneyBag!
non-null

The total line price after all discounts on the line item, including both line item level discounts and code-based line item discounts, are applied.

•ReturnReason!
non-nullDeprecated

Was this section helpful?


Was this section helpful?