New GraphQL fields for return management

We're introducing new fields to help you better manage and track returns:

Quantity tracking fields

The following fields are now available on both ExchangeLineItem and ReturnLineItem objects:

• processedQuantity - Tracks the quantity of a return that has been processed.
• processableQuantity - Indicates the quantity ready for processing.
• unprocessedQuantity - Shows the remaining unprocessed quantity.

Return timestamps

You can now retrieve important timestamps for returns:

• Return.closedAt - The timestamp when the return was closed.
• Return.createdAt - The timestamp when the return was created.
• Return.requestApprovedAt - The timestamp when the return request was approved.
• ReverseFulfillmentOrderDisposition.createdAt - The timestamp when the disposition was created.

Breaking change

ExchangeLineItem.lineItem is now deprecated. Please use ExchangeLineItem.lineItems instead. If an exchange line item has been processed multiple times, it will have multiple associated line items. The lineItem field will only return the first associated line item.

Availability

These fields officially launched in API version 2025-07.