New response elements in the MWS Orders API section
A number of sellers have been requesting that the Amazon Marketplace Web Service (Amazon MWS) Orders API section return the buyer’s name and e-mail address. The Amazon MWS team is happy to announce that we have heard your requests and have added those and other response elements to the Orders API section. If you have been using an order report from the Amazon MWS Reports API section to retrieve your customers’ names and anonymized e-mail addresses, you can now more easily retrieve this information using the Orders API section.
Here’s what we’ve added to the Order response element, returned by the ListOrders, ListOrdersByNextToken, and GetOrder operations:
- MarketplaceId. If you sell in multiple marketplaces, you can now identify the marketplace that your orders were placed in with the MarketplaceId response element.
- BuyerName. You can now associate the buyer’s name with the orders that the Orders API section returns.
- BuyerEmail. The Orders API section returns the buyer’s anonymized e-mail address, so you can communicate with your buyers and identify repeat buyers.
- ShipServiceLevelCategory. This response element indicates the type of shipping that a customer requested when they placed their order.
We’ve also added a new element to the OrderItem response element, returned by the ListOrderItems and ListOrderItemsByNextToken operations:
- GiftWrapLevel. You can now see the gift wrap level that a customer specified when they placed their order.
Also note that we increased the throttling limits for the Orders API section. The new throttling limits are as follows:
- The maximum request quota that the ListOrders and ListOrdersByNextToken operations share was increased from 4 to 6. The restore rate that the two operations share was increased from one request every 10 minutes to one request every 5 minutes.
- The maximum request quota that the ListOrderItems and ListOrderItemsByNextToken operations share was increased from 10 to 15. The restore rate that the two operations share was increased from one request every 12 seconds to one request every 6 seconds.