listings_getListingsRestrictions
Check whether you are approved to sell an ASIN in a given condition.
readAmazon Seller (SP-API)sp.listingsRestrictions_2021-08-01
Amazon SP-API · getListingsRestrictions · GET /listings/2021-08-01/restrictions Account types: Seller Central only (Amazon rejects this endpoint for Vendor Central accounts with Unauthorized.) Returns list of restrictions with reasons and approval links. Use before attempting to create a listing for a new ASIN to verify eligibility. An empty data.restrictions means you may list the ASIN in that condition; otherwise follow reasons[].links[].resource to apply — no link means no self-service path.
Call it
In an AI client (MCP)
{
"name": "listings_getListingsRestrictions",
"arguments": {
"store": "myStore-US",
"asin": "<asin>"
}
}From code (Tool API)
curl -X POST https://api.sellersheetai.com/api/v1/tools/listings_getListingsRestrictions \
-H "Authorization: Bearer $SELLERSHEET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"store":"myStore-US","asin":"<asin>"}'Early access — the Tool API is open on request, contact us.
Arguments
| Name | Type | Description |
|---|---|---|
storerequired | string | the store ref `<store>-<CC>` (name-country, e.g. 'myStore-US') — one of get_user_context's store_refs, verbatim. |
asinrequired | string | the ASIN (e.g. 'B0XXXXXXXX'). |
condition_type | string | the offer condition to check. Default: 'new_new'. Allowed: 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.new_newnew_open_boxnew_oemrefurbished_refurbishedused_like_newused_very_goodused_goodused_acceptablecollectible_like_newcollectible_very_goodcollectible_goodcollectible_acceptableclub_clubDefault: "new_new" |
reason_locale | string | Locale for reason text localization (e.g. 'en_US', 'fr_CA', 'fr_FR'). Defaults to the marketplace's primary language. Falls back to 'en_US' if the requested locale is unavailable. |
product_type | string | Amazon product type of the item, e.g. 'SHIRT'. With it Amazon also evaluates GTIN-exemption restrictions for that product type; without it only brand restrictions (this tool takes no brand argument). Get the value from productTypeDefinitions_searchDefinitionsProductTypes or catalogItems_getCatalogItem. |
Result
Every tool answers {notification, data, human_action}; data carries:
data.restrictions— list of restriction objects, each with: - marketplaceId - conditionType (the condition the restriction applies to) - reasons[]: each has message, optional reasonCode ('APPROVAL_REQUIRED' | 'ASIN_NOT_FOUND' | 'NOT_ELIGIBLE'), and links[] (path-forward resources: resource URI, verb 'GET', title) — typically the approval/application link.