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

Frequently Asked Questions

Developer Profile FAQ

1. What is the Developer Profile?

The Developer Profile (formerly the Developer Registration and Assessment form) allows developers to submit information about their organization and applications. Amazon then uses this information to assess compliance with our Amazon Selling Partner API Acceptable Use Policy and the Data Protection Policy requirements and ensures that we provide the level of access that you require and qualify for. All new and existing developers requiring additional data access are required to submit their responses to the Developer Profile..

2. What should I expect after I submit my Developer Profile?

When you submit the Developer Profile, a support case is automatically created for you. We will contact you with next steps, if any.

3. Can I save a draft of my Developer Profile and return to complete it later?

If you are completing your Developer Profile for the first time, you may save a draft and return to complete it later. If you are modifying an existing Developer Profile, updates save only after you have submitted for review.

4. I am a developer with multiple developer IDs. Do I need to submit a separate Developer Profile for each developer ID?

No, you do not need to submit a Developer Profile multiple times. If you have multiple developer IDs that support the same application, please enter them in the field under If you are currently a developer, please provide your developer ID(s). Note that if you have multiple developer IDs, separate them with commas.

5. How do I know what roles I should select in the Developer Profile?

Choose the roles you require for your application(s) based on the role descriptions here - https://github.com/amzn/selling-partner-api-docs/blob/main/guides/roles/Roles-in-the-Selling-Partner-API.md. Note that access to the Selling Partner API follows the principle of least privilege, meaning that you will not be able to access APIs within roles unless you explicitly select those roles in your Developer Profile.

6. How can I access my support case log?

To access your case log, sign into the Seller Central account that is associated with your Amazon MWS Access Keys. On the Seller Central gateway page, at the Manage Your Case Log widget, click View your case log. Note that you must be the primary account holder to view this page.

7. What if I want to edit or update my submission?

If the Developer Profile is under Amazon review, you will be unable to edit the Developer Profile until the review is complete. However, you will be able to view your submission. If you would like to update the Developer Profile while a review is in progress, please indicate the question(s) that you want to change and provide your updated response(s) in the support case log that was created after you submitted the form. After the review is complete, you are free to edit the Developer Profile if your security controls, use case, or data access needs to change.

8. Can I hire someone to help me meet the requirements described in the Data Protection Policy?

Yes. The AWS Partner Network is a resource that might be of assistance.

9. I want to submit my Developer Profile but I cannot sign into my Seller Central account to access the form. What should I do?

To get help signing into your Seller Central account, go to Seller Central sign in help. If you are still unable to sign in, click this link to create a support case: https://sellercentral.amazon.com/cu/help/contact-us. On the Seller Central Technical Support Page: (1) In the Topic list, select Other question or request. (2) In the Business Name box, enter the name associated with your developer account. (3) In the Primary E-mail recipient box, enter your email address. (4) In the Question or Comment box, enter "I do not know my selling account ID or email. My Amazon MWS Developer ID is xxx. Please assist." (5) Click Send message to create a support case.

10. How was my level of Selling Partner API access decided?

Access decisions are made based on the information that you provide in your Developer Profile, including but not limited to your application functionality and your compliance with the Acceptable Use Policy and the Data Protection Policy. Our goal is to provide you only with the data that is relevant to you in order to protect customers and simplify your data protection obligations.

11. Why was my request for Selling Partner API access denied?

The decision to grant or deny Selling Partner API access is made based on the information that you provide in your Developer Profile, including but not limited to your application functionality and your compliance with the Acceptable Use Policy and the Data Protection Policy. We cannot provide detailed information about how we determine Selling Partner API eligibility, but we prioritize data security in these decisions.

12. What should I do if I want a different level of Selling Partner API access in the future?

You can edit your Developer Profile and select additional or fewer roles at any time except for when your submission is under Amazon review. To change your roles, go to the Developer Profile and check/uncheck the roles you wish to access, complete the appropriate questions, and submit your Developer Profile for Amazon review.

13. What should I do if I believe that my request for Selling Partner API access was wrongly denied?

Access decisions are made based on the information that you provide in the Developer Registration and Assessment form, but we will consider appeals on a case-by-case basis. If you believe that we misunderstood your Developer Profile inputs, or that the denial of access will materially impact the application functionality that you provide under the terms of the Acceptable Use Policy, please respond to your Developer Profile support case at least five business days prior to your adjustment date and ask for an "Appeal Request". Please clearly state the reason for your request and offer a detailed description of the application functionality that is impacted by the access denial or removal.

14. I have been notified that my Amazon MWS level of access is changing. How should I adjust my application in order to prevent breakage or service interruptions?

In order to determine the adjustments that you need to make to your application, please read the document attached to your Developer Profile support case. This document outlines the updates to Amazon MWS responses based on information you provided in your Developer Profile. You may need to conduct a review of your application to determine whether it can safely handle receiving null values for data you may have previously used, either directly or as lookup values. You may find it useful to review the "Building robust Amazon MWS applications" topic in the Amazon MWS Developer Guide here: Building robust Amazon MWS applications.

15. I have been notified that my Amazon MWS level of access is changing. What if I need more time to make adjustments to my software application?

We will consider extensions on a case-by-case basis to allow additional time to modify your application to handle updates to MWS responses. If you believe that you require additional time to update your application, please respond to your Developer Registration and Assessment form support case at least five business days prior to your adjustment date and ask for an "Extension Request". Please clearly state the reason for your extension request and the work that you intend to complete during the extension period.

16. I have been notified that my Amazon MWS level of access is changing. How should I adjust my application in order to prevent breakage or service interruptions?If I have multiple seller accounts with MWS access, do I need to complete a Developer Profile on each one to get access to Selling Partner API?

We require only one Developer Profile per organization. It is a best practice to select a single seller account to manage all Selling Partner API access. Unlike Amazon MWS credentials, Selling Partner API applications are global, meaning you do not need a region-specific seller account to make calls to that region.

General FAQ

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. XML data integration with Amazon enables higher levels of selling automation, which helps sellers grow their business. Developers use Amazon MWS to build applications that help sellers increase selling efficiency, reduce labor requirements, and improve response time to customers.

How much does it cost to use Amazon MWS?

There are no fees associated with Amazon MWS, but you must have a Professional selling plan to use it. For more information, see Selling plans in the Seller Central Help.

How do I get help using Amazon MWS?

First, make sure you have read the documentation provided for each API section. If you need additional help, go to the Marketplace Web Service (Amazon MWS) Questions forum, search to find out if your question has already been resolved on the forum, or create a new forum thread. If you still require assistance, you can submit your question using the Contact Amazon MWS form.

How do I register for Amazon MWS?

  1. Go to the User Permissions page in Seller Central and log into your Amazon selling account as the primary account holder.
  2. Under Amazon MWS Developer Access Keys, click the Visit Developer Credentials button.
  3. On Developer Central page, under Are you a software developer building applications using MWS?, click the apply for access here link, and then follow the instructions on the Amazon MWS Developer Registration and Assessment form.

We will evaluate the information that you provide in the form and then follow up with a support case log and next steps. For more information about developer registration and assessment, see Developer Profile FAQ at the top of this page.

I am a developer and I want to develop Amazon MWS applications for sellers. What should I do?

Only the owner of an Amazon selling account can authorize an application developer to access their selling account. You as the application developer must first register for Amazon MWS to get your Developer ID and developer credentials. Then, give your Developer ID to the seller who wants to use your services as a developer. When the seller authorizes you as a developer, they use your Developer ID to give you developer access to their selling account. The seller must also provide you with their Seller ID so you can make calls to Amazon MWS on their behalf. You can give an Amazon seller the following instructions to guide them through the process of authorizing you as a developer.

Instructions for a seller to authorize a developer to access their selling account

  1. Go to the Manage your apps page in Seller Central and log into your Amazon selling account as the primary account holder.
  2. Click the Authorize new developer button and follow the authorization workflow.

Where do I find my identifiers and developer credentials?

  1. Go to the User Permissions page in Seller Central and log into your Amazon selling account as the account holder.
  2. Under Amazon MWS Developer Access Keys, click the Visit Developer Credentials button.

    The Developer Central page appears.

  3. Under MWS credentials, click the view link.

I am an Amazon seller and I want authorize a developer to access my selling account using Amazon MWS. What should I do?

Use the following instructions to authorize an application developer to access your selling account using Amazon MWS. The application developer should have given you their Developer ID.

  1. Go to the Manage your apps page in Seller Central and log into your Amazon selling account as the primary account holder.
  2. Click the Authorize new developer button and follow the authorization workflow.

I am a seller who has authorized a developer to access my selling account. How do I revoke that authorization?

To revoke authorization for a developer to access your selling account:

  1. Go to the Manage your apps page in Seller Central and log into your Amazon selling account as the primary account holder.
  2. Click the Disable button for the application that you want to revoke access for.

What is the Amazon MWS sunset policy?

When a new version of an Amazon Marketplace Web Service (Amazon MWS) API section is released, a sunset date for the previous version is set. The sunset date for the previous version is announced on the Marketplace Web Service (Amazon MWS) Questions forum and is also on the relevant API section page on the Amazon MWS portal.

Products FAQ

Why do Products operations and notifications not return Buy Box values for used products outside of North America?

This is due to a known problem with the Products service. We do not have any estimate for when it will be fixed. We do not have a workaround.