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.
- If you have a self-authorized, private application, refer to Important migration dates and information for private developers.
- If you have a third-party, public application, refer to Important migration dates and information for public developers.
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
Amazon MWS Section | SP-API | Deprecation Date for Private Apps |
---|---|---|
Orders API section | Orders API | August 31, 2023 |
Merchant Fulfillment API section | Merchant Fulfillment API | August 31, 2023 |
Reports API section | Reports API | August 31, 2023 |
Products API section - Product Fees | Product Fees API | March 31, 2024 |
Products API section - Product Listings | Catalog Items API | March 31, 2024 |
Products API section | Pricing API | March 31, 2024 |
Feeds API section | Feeds API | March 31, 2024 |
Finances API section | Finances API | March 31, 2024 |
Fulfillment Inbound Shipment API section | Fulfillment Inbound API | March 31, 2024 |
Fulfillment Inventory API section | FBA Inventory API | March 31, 2024 |
Sellers API section | Sellers API | March 31, 2024 |
Subscriptions API section | Notifications API | March 31, 2024 |
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 Section | SP-API | Deprecation Date for Public Apps |
---|---|---|
Orders API section | Orders API | July 31, 2022 |
Merchant Fulfillment API section | Merchant Fulfillment API | July 31, 2022 |
Products API section - Product Fees | Product Fees API | September 30, 2022 |
Products API section - Product Listings | Catalog Items API | September 30, 2022 |
Products API section - Product Pricing | Pricing API | September 30, 2022 |
Feeds API section | Feeds API | December 31, 2022 |
Finances API section | Finances API | December 31, 2022 |
Fulfillment Inbound Shipment API section | Fulfillment Inbound API | December 31, 2022 |
Fulfillment Inventory API section | FBA Inventory API | December 31, 2022 |
Sellers API section | Sellers API | December 31, 2022 |
Subscriptions API section | Notifications API | December 31, 2022 |
Migration resources
- Amazon MWS to SP-API Migration Guide
- SP-API Migration Frequently Asked Questions
- Selling Partner API videos
Contact us
Contact: Selling Partner API Developer Support
Contact URL: https://sellercentral.amazon.com/gp/mws/contactus.html