SP-API Migration Hub

Overview - Migration from Amazon MWS (MWS) to Selling Partner API (SP-API)

As mentioned in our October 2020 Selling Partner API (SP-API) launch announcement, all public MWS applications will need to migrate to SP-API. The launch of SP-API represents the next generation API for programmatic access to Amazon features for sellers. All new development is occurring in SP-API and this includes several enhanced data protection and security features. This change is being made to ensure developers are using the latest technology and features for the benefit of both selling partners and customers. We are focused on providing the necessary information, tools, and assistance needed to successfully migrate your app to SP-API.

📘

All third-party public developers using any MWS API sections must fully migrate to Selling Partner API (SP-API) by December 31, 2022.

Summary of changes

We have announced three migration due dates within 2022 that will affect third-party MWS public applications. This section contains details about these due dates.

Amazon MWS Orders, Reports, and Merchant Fulfillment (MFN) sections

Effective July 31, 2022, all third-party developed applications (public applications) authorized by selling partners, that are using the following Amazon MWS sections, must migrate to the Selling Partner API (SP-API):

  • Orders
  • Reports
  • Merchant Fulfillment (MFN)

🚧

Deadline

Starting August 1st, 2022, public applications that have not migrated will be unable to successfully call these sections in Amazon MWS.

MWS Products section

Effective September 30, 2022, all third-party developed applications (public applications) authorized by selling partners using the Amazon MWS Products section must migrate to the Selling Partner API for Catalog Items and Selling Partner API for Listings Items.

The Selling Partner API for Catalog Items v0 operations will also be deprecated on September 30, 2022.

🚧

Deadline

Starting October 1st, 2022, public applications that do not migrate will be unable to successfully call these sections in Amazon MWS.

All other MWS sections

Effective December 31, 2022, all third-party developed applications (public applications) authorized by selling partners must be fully integrated with SP-API for all remaining application operations. This includes applications using the following Amazon MWS sections:

  • Feeds API
  • Finances API
  • Fulfillment Inbound Shipment API
  • Fulfillment Inventory API
  • Fulfillment Outbound Shipment API
  • Recommendations API
  • Sellers API
  • Subscriptions API
  • Push Notifications Schemas

🚧

Deadline

After January 1st, 2023, public applications that do not fully migrate will be unable to successfully call any sections in Amazon MWS.

Restricted Data Tokens (RDT)

Effective July 31, 2023, all developers whose SP-API applications have Direct-to-Consumer Fulfillment, Tax, Shipping, or Reports use cases must use the new Restricted Data Token (RDT) via the Tokens API to make a successful API call for some operations.

RDTs are a new access protocol for some operations and report types in the Orders, MFN, Shipping, and Reports sections. Refer to the Amazon MWS to SP-API Migration Guide for more information.

The Selling Partner API for tokens provides a secure way to access a customer's personally identifiable information (PII). You can call the Tokens API to get a Restricted Data Token for one or more restricted resources that you specify. The RDT authorizes subsequent calls to restricted operations that correspond to the restricted resources that you specified.

For more information, see the Tokens API Use Case Guide.

🚧

Deadline

Starting July 31, 2023, all developers whose SP-API applications have Direct-to-Consumer Fulfillment, Tax, Shipping, or Reports use cases must use the new Restricted Data Token (RDT) via the Tokens API to make a successful API call for some operations.

Amazon MWS to Selling Partner API mapping

Migration resources

Contact us

Contact : Selling Partner API Developer Support
Contact URL : https://sellercentral.amazon.com/gp/mws/contactus.html