getListingsRestrictions

get https://sellingpartnerapi-na.amazon.com/listings/2021-08-01/restrictions

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.

Query Params

asin

string

required

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

conditionType

string

The condition used to filter restrictions.

sellerId

string

required

A selling partner identifier, such as a merchant account.

marketplaceIds

array of strings

required

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

marketplaceIds*

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.

Responses

Response body

object

restrictions

array of objects

required

restrictions*

object

marketplaceId

string

required

A marketplace identifier. Identifies the Amazon marketplace where the restriction is enforced.

conditionType

string

The condition that applies to the restriction.

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

Show Details

new_new	New
new_open_box	New - Open Box.
new_oem	New - OEM.
refurbished_refurbished	Refurbished
used_like_new	Used - Like New.
used_very_good	Used - Very Good.
used_good	Used - Good.
used_acceptable	Used - Acceptable.
collectible_like_new	Collectible - Like New.
collectible_very_good	Collectible - Very Good.
collectible_good	Collectible - Good.
collectible_acceptable	Collectible - Acceptable.
club_club	Club

reasons

array of objects

A list of reasons for the restriction.

reasons

object

message

string

required

A message describing the reason for the restriction.

reasonCode

string

A code indicating why the listing is restricted.

APPROVAL_REQUIRED ASIN_NOT_FOUND NOT_ELIGIBLE

Show Details

APPROVAL_REQUIRED	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.
ASIN_NOT_FOUND	The specified ASIN does not exist in the requested marketplace.
NOT_ELIGIBLE	Not eligible to create a listing for the specified ASIN. No path forward link will be provided to remove the restriction.

links

array of objects

A list of path forward links that may allow Selling Partners to remove the restriction.

links

object

resource

uri

required

The URI of the related resource.

verb

string

required

The HTTP verb used to interact with the related resource.

GET

Show Details

GET	The provided resource is accessed with the HTTP GET method.

title

string

The title of the related resource.

type

string

The media type of the related resource.

Headers

object

x-amzn-RateLimit-Limit

string

Your rate limit (requests per second) for this operation.

x-amzn-RequestId

string

Unique request reference identifier.

Language


xxxxxxxxxx
1
curl --request GET \
2
     --url https://sellingpartnerapi-na.amazon.com/listings/2021-08-01/restrictions \
3
     --header 'accept: application/json'


xxxxxxxxxx
21
 
1
{
2
  "restrictions": [
3
    {
4
      "marketplaceId": "ATVPDKIKX0DER",
5
      "conditionType": "used_acceptable",
6
      "reasons": [
7
        {
8
          "message": "You cannot list the product in this condition.",
9
          "links": [
10
            {
11
              "resource": "https://sellercentral.amazon.com/hz/approvalrequest/restrictions/approve?asin=B0000ASIN1",
12
              "verb": "GET",
13
              "title": "Request Approval via Seller Central.",
14
              "type": "text/html"
15
            }
16
          ]
17
        }
18
      ]
19
    }
20
  ]
21
}

200Successfully retrieved the listings restrictions.

400Request has missing or invalid parameters and cannot be parsed.

403Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.

404The resource specified does not exist.

413The request size exceeded the maximum accepted size.

415The request payload is in an unsupported format.

429The frequency of requests was greater than allowed.

500An unexpected condition occurred that prevented the server from fulfilling the request.

503Temporary overloading or maintenance of the server.