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.
Your access to Amazon MWS
on the role Amazon assigns you after you submit the Developer Registration and Assessment form
. For more information see Registering to use Amazon MWS
The following operations are included in the Orders API section:
||Returns orders created or updated during a time frame
that you specify.
||Returns the next page of orders using the
||Returns orders based on the
AmazonOrderId values that you
||Returns order items based on the
AmazonOrderId that you specify.
||Returns the next page of order items
using the NextToken parameter.
||Returns the operational status of the Orders API section.
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
When to use the Orders API section
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:
||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:
- Gift wrapped book, quantity of one
- Non-gift wrapped book, quantity of two
||The following are both considered orders:
- A collection of order items sold on Amazon with identical
values for the following attributes:
- Shipping address
- Shipping speed
- A Multi-Channel Fulfillment order (an order not sold on
Amazon's retail website but fulfilled using your Fulfillment
by Amazon inventory).
||An order that contains items with a manufacturer's release date
that is in the future. Note that pre-orders are available only in
||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.
The following scenarios are supported by the Orders API section
- Data synchronization:
- Synchronize Amazon order data with order data in your local ordering
- Get order status data on your Amazon sales so you can fulfill your
orders using your own fulfillment system
- Migrate your historical order data to a third-party integrator
- Order research and customer service:
- Get order details for researching issues and answering customer
You can perform the following business analytics with the synchronization data that
the Orders API section
- Support for FBA replenishment and
- Find SKUs with high or low sales volumes
- Monitor sales trends by SKU
- Support for sales channel and fulfillment channel decisions:
- Find SKU sales trends by sales channel and by fulfillment channel
- Monitor sales trends by SKU
- Issue monitoring:
- Find SKUs that have been in a given state for too long
- Find unexpected changes in sales trends by SKU