Get listings restrictions for an item in the catalog

Learn how to retrieve any listings restrictions for an existing item in the Amazon catalog.

Prerequisites

To complete this tutorial, you need:

• Authorization from the selling partner for whom you are making calls. Refer to Authorizing Selling Partner API applications for more information.
• The Product Listing role assigned to your developer profile.
• The Product Listing role selected in the App registration page for your application.
• A basic understanding of the Selling Partner API. Refer to What is the Selling Partner API? for more information.

Call the getListingsRestrictions operation

Call the getListingsRestrictions operation to retrieve listings restrictions for a catalog item that you identify by ASIN.

A successful response returns information about all applicable restrictions, if any. If there are no restrictions for the specified conditionType (when provided) in the specified Amazon store, the list of restrictions in the response will be empty.

When restrictions do exist for the specified conditionType (when provided) in the specified Amazon store, evaluate the reasons array in the response to determine the reason and to identify next steps, if any. Each reason has a reasonCode indicating why the listing is restricted.

When is approval required?

Amazon requires that selling partners obtain approval before listing certain items for sale. The approval process can include a variety of approval requirements and qualifications. If the reasonCode in the response indicates that approval is required, the selling partner can apply for approval to list the item.

In this case, use the links array in the response to direct the selling partner to the provided URL, where they can follow the instructions to apply for approval.