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.
With the Orders API section of Amazon Marketplace Web Service (Amazon MWS), you can build simple applications that retrieve only the order information that you need. This enables you to develop fast, flexible, custom applications in areas like order synchronization, order research, and demand-based decision support tools.
The following operations are included in the Orders API section:
Operation | Description | Availability |
---|---|---|
ListOrders | Returns orders created or updated during a time frame that you specify. | All marketplaces. |
ListOrdersByNextToken | Returns the next page of orders using the NextToken parameter. | All marketplaces. |
GetOrder | Returns orders based on the AmazonOrderId values that you specify. | All marketplaces. |
ListOrderItems | Returns order items based on the AmazonOrderId that you specify. | All marketplaces. |
ListOrderItemsByNextToken | Returns the next page of order items using the NextToken parameter. | All marketplaces. |
GetServiceStatus | Returns the operational status of the Orders API section. | All marketplaces. |
You can retrieve order item information by first using the ListOrders operation to find orders created or updated during a time frame that you specify. An AmazonOrderId is included with each order that is returned. You can then use these AmazonOrderId values with the ListOrderItems operation to get detailed order item information for each order.
To determine the URL to use when sending requests to the Orders API section, add "/Orders/2013-09-01" to the endpoint for your marketplace. For example, if your marketplace is US, the URL would be https://mws.amazonservices.com/Orders/2013-09-01
The Orders API section is optimized for data synchronization, retrieving order updates in real-time, and order research. For bulk order data reporting, you should create order reports with the Reports API section. For more information about the Reports API section, see the Reports API section documentation.
The following table defines terminology for this API section:
Term | Definition |
---|---|
Order item | An item and a quantity. For example, if a customer buys three
copies of a particular book, the order contains one order item with
a quantity of three. If one of the copies is to be gift wrapped, the
order now contains the following two order items:
|
Order | The following are both considered orders:
|
Pre-order | An order that contains items with a manufacturer's release date that is in the future. Note that pre-orders are available only in Japan. |
Standard order | An order that contains items with available inventory. |
Note for Fulfillment by Amazon (FBA) sellers who use Multi-Channel Fulfillment: If you submit a removal order and do not include ShippingAddress, the Orders API section will not return ShippingAddress for that order. For more information about Multi-Channel Fulfillment, see the Help pages for the Amazon Seller Central website in your marketplace.