"description":"The Selling Partner API for Listings Restrictions provides programmatic access to restrictions on Amazon catalog listings.\n\nFor more information, see the [Listings Restrictions API Use Case Guide](doc:listings-restrictions-api-v2021-08-01-use-case-guide).",
"description":"A list of restrictions for the specified Amazon catalog item.",
"type":"object",
"properties":{
"restrictions":{
"items":{
"$ref":"#/definitions/Restriction"
},
"type":"array"
}
},
"required":[
"restrictions"
]
},
"Restriction":{
"description":"A listing restriction, optionally qualified by a condition, with a list of reasons for the restriction.",
"type":"object",
"properties":{
"marketplaceId":{
"description":"A marketplace identifier. Identifies the Amazon marketplace where the restriction is enforced.",
"type":"string"
},
"conditionType":{
"description":"The condition that applies to the restriction.",
"type":"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"
],
"x-docgen-enum-table-extension":[
{
"value":"new_new",
"description":"New"
},
{
"value":"new_open_box",
"description":"New - Open Box."
},
{
"value":"new_oem",
"description":"New - OEM."
},
{
"value":"refurbished_refurbished",
"description":"Refurbished"
},
{
"value":"used_like_new",
"description":"Used - Like New."
},
{
"value":"used_very_good",
"description":"Used - Very Good."
},
{
"value":"used_good",
"description":"Used - Good."
},
{
"value":"used_acceptable",
"description":"Used - Acceptable."
},
{
"value":"collectible_like_new",
"description":"Collectible - Like New."
},
{
"value":"collectible_very_good",
"description":"Collectible - Very Good."
},
{
"value":"collectible_good",
"description":"Collectible - Good."
},
{
"value":"collectible_acceptable",
"description":"Collectible - Acceptable."
},
{
"value":"club_club",
"description":"Club"
}
]
},
"reasons":{
"description":"A list of reasons for the restriction.",
"type":"array",
"items":{
"$ref":"#/definitions/Reason"
}
}
},
"required":[
"marketplaceId"
]
},
"Reason":{
"description":"A reason for the restriction, including path forward links that may allow Selling Partners to remove the restriction, if available.",
"type":"object",
"properties":{
"message":{
"description":"A message describing the reason for the restriction.",
"type":"string"
},
"reasonCode":{
"description":"A code indicating why the listing is restricted.",
"type":"string",
"enum":[
"APPROVAL_REQUIRED",
"ASIN_NOT_FOUND",
"NOT_ELIGIBLE"
],
"x-docgen-enum-table-extension":[
{
"value":"APPROVAL_REQUIRED",
"description":"Approval is required to create a listing for the specified ASIN. A path forward link will be provided that may allow Selling Partners to remove the restriction."
},
{
"value":"ASIN_NOT_FOUND",
"description":"The specified ASIN does not exist in the requested marketplace."
},
{
"value":"NOT_ELIGIBLE",
"description":"Not eligible to create a listing for the specified ASIN. No path forward link will be provided to remove the restriction."
}
]
},
"links":{
"description":"A list of path forward links that may allow Selling Partners to remove the restriction.",
"type":"array",
"items":{
"$ref":"#/definitions/Link"
}
}
},
"required":[
"message"
]
},
"Link":{
"description":"A link to resources related to a listing restriction.",
"type":"object",
"properties":{
"resource":{
"description":"The URI of the related resource.",
"type":"string",
"format":"uri"
},
"verb":{
"description":"The HTTP verb used to interact with the related resource.",
"type":"string",
"enum":[
"GET"
],
"x-docgen-enum-table-extension":[
{
"value":"GET",
"description":"The provided resource is accessed with the HTTP GET method."
}
]
},
"title":{
"description":"The title of the related resource.",
"type":"string"
},
"type":{
"description":"The media type of the related resource.",
"type":"string"
}
},
"required":[
"resource",
"verb"
]
},
"ErrorList":{
"description":"A list of error responses returned when a request is unsuccessful.",
"type":"array",
"items":{
"$ref":"#/definitions/Error"
}
},
"Error":{
"description":"Error response returned when the request is unsuccessful.",
"properties":{
"code":{
"description":"An error code that identifies the type of error that occurred.",
"type":"string"
},
"message":{
"description":"A message that describes the error condition.",
"type":"string"
},
"details":{
"description":"Additional details that can help the caller understand or fix the issue.",
"description":"Returns listing restrictions for an item in the Amazon Catalog. \n\n**Usage Plan:**\n\n| Rate (requests per second) | Burst |\n| ---- | ---- |\n| 5 | 10 |\n\nThe `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](doc:usage-plans-and-rate-limits-in-the-sp-api).",
"description":"The Amazon Standard Identification Number (ASIN) of the item.",
"required":true,
"type":"string",
"x-example":"B0000ASIN1"
},
{
"name":"conditionType",
"in":"query",
"description":"The condition used to filter restrictions.",
"required":false,
"type":"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"
],
"x-example":"used_very_good",
"x-docgen-enum-table-extension":[
{
"value":"new_new",
"description":"New"
},
{
"value":"new_open_box",
"description":"New - Open Box."
},
{
"value":"new_oem",
"description":"New - OEM."
},
{
"value":"refurbished_refurbished",
"description":"Refurbished"
},
{
"value":"used_like_new",
"description":"Used - Like New."
},
{
"value":"used_very_good",
"description":"Used - Very Good."
},
{
"value":"used_good",
"description":"Used - Good."
},
{
"value":"used_acceptable",
"description":"Used - Acceptable."
},
{
"value":"collectible_like_new",
"description":"Collectible - Like New."
},
{
"value":"collectible_very_good",
"description":"Collectible - Very Good."
},
{
"value":"collectible_good",
"description":"Collectible - Good."
},
{
"value":"collectible_acceptable",
"description":"Collectible - Acceptable."
},
{
"value":"club_club",
"description":"Club"
}
]
},
{
"name":"sellerId",
"in":"query",
"description":"A selling partner identifier, such as a merchant account.",
"required":true,
"type":"string"
},
{
"name":"marketplaceIds",
"in":"query",
"description":"A comma-delimited list of Amazon marketplace identifiers for the request.",
"required":true,
"type":"array",
"items":{
"type":"string"
},
"collectionFormat":"csv",
"x-example":"ATVPDKIKX0DER"
},
{
"name":"reasonLocale",
"in":"query",
"description":"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.",
"required":false,
"type":"string",
"x-example":"en_US"
}
],
"responses":{
"200":{
"description":"Successfully retrieved the listings restrictions.",
"schema":{
"$ref":"#/definitions/RestrictionList"
},
"headers":{
"x-amzn-RateLimit-Limit":{
"description":"Your rate limit (requests per second) for this operation.",
"description":"Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.",