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

What is Amazon MWS?

Amazon Marketplace Web Service (Amazon MWS) is an integrated web service API that helps Amazon sellers to programmatically exchange data on listings, orders, payments, reports, and more. Data integration with Amazon enables high levels of selling automation, which can help sellers grow their business. By using Amazon MWS, sellers can increase selling efficiency, reduce labor requirements, and improve response time to customers.

There are no fees associated with Amazon MWS, but to use the Amazon MWS API you must have an Amazon MWS-eligible seller account and you must register to use Amazon MWS.

What Amazon MWS Provides

With Amazon MWS, you can build applications for your own Amazon seller account. You can also build applications for other sellers to help them manage their online business. Using Amazon MWS you can create applications that look up products for sale, download orders for fulfillment, confirm shipment, and schedule and receive reports. These API operations are accessible by using a web service interface.

Amazon MWS provides the following features:
  • Inventory management — You can perform batch uploads of inventory, add products, check inventory levels, examine pricing information, and other inventory management tasks.
  • Order management — You can download order information, obtain payment data, acknowledge orders, and schedule reports.
  • Reports management — You can request a variety of reports as well as query the status of these reports, and then download them.
For Fulfillment by Amazon (FBA) sellers, Amazon MWS also allows you to:
  • Create inbound shipments to an Amazon fulfillment center — You can automate the process for creating labels for units you ship to a fulfillment center.
  • Check status of inbound shipments — You can check to see if your shipment has reached a fulfillment center and, if so, whether the shipment has been processed.
  • Submit fulfillment orders — By integrating your system with Amazon MWS, you can enable your customers to submit multi-channel fulfillment orders at any time. There is no lag time while you process or batch orders.
  • Track and manage outbound shipment requests — Once orders have left an Amazon fulfillment center, you can track shipments and keep your customers aware of arrival times.

The MWS API

The Amazon MWS API is divided into sections based on functionality. The following is a summary of the API organization. Further information can be found in the Amazon MWS API References.

Feeds API
The Amazon MWS Feeds API lets you upload inventory and order data to Amazon.
Finances API
The Finances API enables you to obtain financial information relevant to your business with Amazon.
Fulfillment Inbound Shipment API
With the Fulfillment Inbound Shipment API, you can create and update inbound shipments of inventory in Amazon's fulfillment network.
Fulfillment Inventory API
The Fulfillment Inventory API can help you stay up-to-date on the availability of your inventory in Amazon's fulfillment network.
Fulfillment Outbound Shipment API
The Fulfillment Outbound Shipment API enables you to fulfill Multi-Channel Fulfillment orders, using your inventory in Amazon's fulfillment network.
Merchant Fulfillment API
The Merchant Fulfillment API provides programmatic access to Buy Shipping Services for sellers, including competitive rates from Amazon-partnered carriers.
Orders API
With the Orders API, you can build simple applications that retrieve only the order information that you need.
Products API
The Products API helps you get information to match your products to existing product listings on Amazon Marketplace websites and to make sourcing and pricing decisions for listing those products on Amazon Marketplace websites.
Recommendations API
The Recommendations API enables you to programmatically retrieve Amazon Selling Coach recommendations by recommendation category.
Reports API
The Reports API lets you request various reports that help you manage your sales on Amazon.
Sellers API
The Sellers API lets sellers retrieve information about their seller account, such as the marketplaces they participate in. Along with listing the marketplaces that a seller can sell in, the API also provides additional information about the marketplace such as the default language and the default currency.
Subscriptions API
The Subscriptions API enables you to subscribe to receive notifications that are relevant to your business with Amazon.
Push Notifications Schemas
The Amazon MWS push notifications enable you to receive information that is relevant to your business with Amazon without having to poll the Amazon MWS service. Instead, the information is sent directly to you when an event occurs to which you are subscribed (see the Subscriptions API).