Listings restrictionsListings Restrictions

Returns listing restrictions for an item in the indicated marketplace

GET
/listings/v4/restrictions

Returns restrictions on listing an item for a given ASIN and seller. A successful response does not guarantee the seller can list — check the restrictions array.

Authorization

walletAuth
AuthorizationBearer <token>

In: header

Query Parameters

asin*string

Walmart Item ID (maps to ASIN in Walmart Seller API)

conditionType*string

Value in

  • "new_new"
  • "used_like_new"
  • "used_very_good"
  • "used_good"
  • "used_acceptable"
  • "collectible_like_new"
  • "collectible_very_good"
  • "collectible_good"
  • "collectible_acceptable"
  • "refurbished_refurbished"
sellerId*string
marketplaceIds*array<string>
reasonLocale?string

Locale for localized restriction reason messages

Default"en_US"

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/listings/v4/restrictions?asin=string&conditionType=new_new&sellerId=string&marketplaceIds=string"
{  "restrictions": [    {      "marketplaceId": "string",      "conditionType": "string",      "reasons": [        {          "message": "string",          "reasonCode": "APPROVAL_REQUIRED",          "links": [            {              "resource": "http://example.com",              "verb": "GET",              "title": "string",              "type": "string"            }          ]        }      ]    }  ]}