Skip to main content
interface

Requires read_returns access scope or read_marketplace_returns access scope.

A return line item of any type.

•String

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

•ID!
non-null

A globally-unique ID.

•Int!
non-null

The quantity being returned.

•Int!
non-null

The quantity that can be refunded.

•Int!
non-null

The quantity that was refunded.

•ReturnReason!
non-null

The reason for returning the item.

•String!
non-null

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


Was this section helpful?

Anchor to Types implemented inTypes implemented in

•OBJECT

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 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.

•ReturnReason!
non-null

The reason for returning the item.

•String!
non-null

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

•Weight

The total weight of the item.

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.

•OBJECT

An unverified return line item.

•String

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

•ID!
non-null

A globally-unique ID.

•Int!
non-null

The quantity being returned.

•Int!
non-null

The quantity that can be refunded.

•Int!
non-null

The quantity that was refunded.

•ReturnReason!
non-null

The reason for returning the item.

•String!
non-null

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

•MoneyV2!
non-null

The unit price of the unverified return line item.


Was this section helpful?