Date: August 6, 2026

A new conditionType query parameter is available in Returns performance metrics requests and responses. Use this parameter to retrieve return performance metrics by item condition. Supported values are NEW, RESOLD, and ALL.

What changed

• Added the conditionType query parameter to Returns performance metrics requests.
• Added the conditionType field to Returns performance metrics responses.
• Supported values for both the request and response are NEW, RESOLD, and ALL.
• If the request doesn't include conditionType, it defaults to ALL, which combines New and Resold return metrics.
• The response returns conditionType: RESOLD only when the seller is enrolled in the Resold category and has orders for resold offers.

Why it matters

This update gives sellers visibility into return performance for resold offers. Sellers enrolled in the Resold category can retrieve return metrics specific to their resold inventory, making it easier to generate accurate reports, monitor performance, and investigate issues.

Next steps

• Pass the conditionType query parameter in the request to retrieve Returns performance metrics for the specified item condition.
• Specify NEW, RESOLD, or ALL to receive metrics for that condition.
• If conditionType is omitted, the request defaults to ALL, which combines New and Resold return metrics.
• Expect conditionType: RESOLD in the response only when the seller is enrolled in the Resold category and has orders for resold offers.
• Review the Returns API documentation and update your integration as needed.