Sign in

v1

latestOpenAPI 3.0.0Apache License 2.02026-07-263171,5614.1 MB
Listings Restrictions v2021-08-01

getListingsRestrictions

Returns listing restrictions for an item in the Amazon Catalog.

Usage Plan:

Rate (requests per second)Burst
510

The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation, when available. The table above indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may see higher rate and burst values then those shown here. For more information, see Usage Plans and Rate Limits in the Selling Partner API.

get/listings/2021-08-01/restrictions

Query parameters

asinstring required

The Amazon Standard Identification Number (ASIN) of the item.

conditionType'new_new' | 'new_open_box' | 'new_oem' | 'refurbished_refurbished' | 'used_like_new' | 'used_very_good' | 'used_good' | 'used_acceptable' | 'collectible_like_new' | 'collectible_very_good' | 'collectible_good' | 'collectible_acceptable' | 'club_club'

The condition used to filter restrictions.

sellerIdstring required

A selling partner identifier, such as a merchant account.

marketplaceIdsstring[] required

A comma-delimited list of Amazon marketplace identifiers for the request.

reasonLocalestring

A locale for reason text localization. When not provided, the default language code of the first marketplace is used. Examples: "en_US", "fr_CA", "fr_FR". Localized messages default to "en_US" when a localization is not available in the specified locale.

productTypestring

The product type of the item. When provided with the brand name, the API evaluates GTIN exemption restrictions in addition to brand restrictions for the specified product type.

Response

Successfully retrieved the listings restrictions.