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 return any listings restrictions.

You can check restrictions using one of the following identifiers:

• ASIN — Check restrictions for a specific catalog item.
• Brand — Check brand gating restrictions for a brand name.
• Brand + product type — Check both brand gating restrictions and GTIN exemption restrictions for a brand and product type combination.

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

When restrictions do exist for the specified conditionType (when provided) in the specified marketplace, 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.

Check restrictions by brand and product type

When you provide the optional productType parameter along with the brand parameter, the API evaluates GTIN exemption restrictions in addition to standard brand gating restrictions. This enables auto-approval of GTIN exemptions for eligible brand and product type combinations.

Note: The productType parameter can only be used in conjunction with brand. If you provide productType without brand, the API returns a 400 Bad Request error.

Request example

GET /listings/2021-08-01/restrictions
  ?brand=ExampleBrand
  &productType=SHIRT
  &sellerId=AXXXXXXXXXXXXX
  &marketplaceIds=ATVPDKIKX0DER
  &conditionType=new_new

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 might be able to apply for approval to list the item.

In this case, use the information in the links array in the response to instruct the selling partner to navigate to the URL link provided, and then to follow the instructions there to apply for approval to list the item.