Listings Restrictions API

Learn how to programmatically identify restrictions on Amazon catalog listings.

You use the Listings Restrictions API to check if there are any restrictions that prevent the creation of a listing for an item in the Amazon catalog. This API supports checking multiple marketplaces for listings restrictions in a single call, and you can optionally filter the restrictions based on condition type. If an item is restricted, you might be able to take additional steps to request approval to create a listing. When approval is required, the API returns next step links so you can pursue approval to create the listing. Refer to the Listings Restrictions API Reference for details about API operations and associated data types and schemas.

You can use the Listings Restrictions API in conjunction with the Listings Items API . For example, you can first determine whether listings restrictions exist using the Listings Restrictions API. If no restrictions exist, you can then call the Listings Items API to create offer-only listings. Refer to the Listings Items API Reference for more information about the Listings Items API.

Current versionLegacy versionsAvailable to sellersAvailable to vendors
v2021-08-01 (Reference | Model)NoneYesYes
Release notes

For releases prior to January 19, 2022, refer to Announcements in the Selling Partner API GitHub repository.

Use cases

The following use case examples are available for the Listings Restrictions API:

To learn more about the terms that are used on this page, refer to Terminology.

Roles

<Roles_listings_restrictions_2021_08_01>