Download OpenAPI specification:Download
The Selling Partner API for Listings Restrictions provides programmatic access to restrictions on Amazon catalog listings.
For more information, see the Listings Restrictions API Use Case Guide.
Returns listing restrictions for an item in the Amazon Catalog.
Usage Plan:
| Rate (requests per second) | Burst |
|---|---|
| 5 | 10 |
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.
| asin required | string The Amazon Standard Identification Number (ASIN) of the item. |
| conditionType | string Enum: "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. |
| sellerId required | string A selling partner identifier, such as a merchant account. |
| marketplaceIds required | Array of strings A comma-delimited list of Amazon marketplace identifiers for the request. |
| reasonLocale | string 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. |
| Content-Type | string Value: "application/json" |
{- "restrictions": [
- {
- "marketplaceId": "ATVPDKIKX0DER",
- "conditionType": "used_acceptable",
- "reasons": [
- {
- "message": "You cannot list the product in this condition.",
- "links": [
- {
- "verb": "GET",
- "title": "Request Approval via Seller Central.",
- "type": "text/html"
}
]
}
]
}
]
}