Amazon Services
Amazon Marketplace Web Service (Amazon MWS) Documentation

Deprecation Notice:

Amazon Marketplace Web Service (MWS) will no longer be available after March 31, 2024. All MWS developers must migrate to Selling Partner API (SP-API) to avoid service disruptions. Refer to the Migration Hub for more information.

Amazon MWS Documentation


Returns a list of return reason codes for a seller SKU in a given marketplace.


The ListReturnReasonCodes operation returns a list of valid return reasons codes for a seller SKU in a given marketplace. Valid reason codes are required in subsequent calls to the CreateFulfillmentReturn operation. See Creating a fulfillment return.


This operation is only available in the US, Germany, France, Italy, UK, Japan, and Australia marketplaces.


The ListReturnReasonCodes operation has a maximum request quota of 30 and a restore rate of two requests every second. For definitions of throttling terminology and for a complete explanation of throttling, see Throttling: Limits to how often you can submit requests in the Amazon MWS Developer Guide.

Request parameters

Name Description Required Values
MarketplaceId The marketplace for which the seller wants return reason codes. No. Not required if SellerFulfillmentOrderId is specified. MarketplaceId values: see Amazon MWS endpoints and MarketplaceId values.

Type: xs:string

SellerFulfillmentOrderId The identifier assigned to the item by the seller when the fulfillment order was created. The service uses this value to determine the marketplace for which the seller wants return reason codes. No. Not required if MarketplaceId is specified. Type: xs:string
SellerSKU The seller SKU for which return reason codes are required. Yes Type: xs:string
Language The language that the TranslatedDescription element of the ReasonCodeDetails response element should be translated into. No The ISO 639-1 format language code. Example: fr_CA

Type: xs:string

Response elements

Name Description
ReasonCodeDetailsList Type: List of ReasonCodeDetails


Example query request

For information about standard request requirements, see Required request parameters.

Show example code Hide example code

↑ Top

Example response

For information about standard response formatting, see Response format.

Show example code Hide example code

<?xml version="1.0"?>
<ListReturnReasonCodesResponse  xmlns="">
                <Description>This is a description of the reason code.</Description>
                <TranslatedDescription>This is an optional translated description of the reason code.</TranslatedDescription>

↑ Top