SP-API Migration Hub

🚧

MWS will no longer be available for use by any developer starting April 1, 2024.

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

All MWS applications must 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, including several enhanced data protection and security features. This change ensures 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.

📘

MWS developer types

Public developer: A developer that builds and offers publicly available applications that are used by other companies.
Private developer: A developer that builds application(s) that integrate their own company with Amazon APIs.

Important migration dates and information for private developers

Select to expand information for private developers.

Summary of changes

We have announced two migration due dates within 2023 and 2024 that will affect MWS private applications. This section contains details about these due dates.

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

Effective August 31, 2023, all private developed applications 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 31, 2023, private applications that have not migrated will be unable to successfully call these sections in Amazon MWS.

Restricted Data Tokens (RDT)

Effective August 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

After August 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.

All other MWS sections

Effective March 31, 2024, all private developed applications must be fully integrated with SP-API for all remaining application operations. This includes applications using the following Amazon MWS sections:

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

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 listCatalogItems and getCatalogItem operations are deprecated as of September 30, 2022.

Amazon MWS to Selling Partner API mapping

Important migration dates and information for public developers

Select to expand information for public developers.

📘

Notice

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

Amazon MWS SectionSP-APIDeprecation Date for Public Apps
Orders API sectionOrders APIJuly 31, 2022
Merchant Fulfillment API sectionMerchant Fulfillment APIJuly 31, 2022
Products API section - Product FeesProduct Fees APISeptember 30, 2022
Products API section - Product ListingsCatalog Items APISeptember 30, 2022
Products API section - Product PricingPricing APISeptember 30, 2022
Feeds API sectionFeeds APIDecember 31, 2022
Finances API sectionFinances APIDecember 31, 2022
Fulfillment Inbound Shipment API sectionFulfillment Inbound APIDecember 31, 2022
Fulfillment Inventory API sectionFBA Inventory APIDecember 31, 2022
Sellers API sectionSellers APIDecember 31, 2022
Subscriptions API sectionNotifications APIDecember 31, 2022

Migration resources

Contact us

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