Reject Recommendations

You can reject a list of recommendations that are recommended for you.

Using ITEM as a recommendationType,

  • You can reject specific item recommendations using the filterCriteria or by providing the list of itemRecommendationUniqueIds.
  • You will need to provide valid rejection code(s) while submitting the reject request. You are required to send the custom rejection message if the rejection code is OTHER_REASON
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

Request payload

string
enum
required
AttributeDescriptionData Type
ITEMTo reject list of recommended itemsstring
Allowed:
filterCriteria
object

Different type of filters can be passed in this object.

itemRecommendationUniqueIds
array of strings

List of item recommendation unique ids to reject.
The size of the list should not exceed 100.
You cannot add filter criteria along with the itemRecommendationUniqueIds list

itemRecommendationUniqueIds
rejectionCodes
array of strings
enum
required

List of rejection codes

AttributeDescriptionData Type
ITEM_DISCONTINUEDAs a seller, I have discontinued this SKU or stopped carrying this product linestring
NOT_SELLING_THESE_ITEMSAs a seller, I don’t intend to sell these items on Walmartstring
ITEM_SEASONAL_OR_NOT_RELEVANTItem is out-of-season or not needed at this timestring
COMPETITOR_ITEMAs a seller, I already carry similar items, thus adding more isn't helpfulstring
NOT_SELLING_THESE_CATEGORIESAs a seller, I don’t intend to sell these categories on Walmartstring
NOT_AUTHORIZEDAs a seller, I lack the required brand permission/authorizationstring
LIMITED_TO_OTHER_MARKETPLACEAs a seller, I intend to sell the rejected items only on other marketplacesstring
NOT_SELLING_THESE_BRANDSAs a seller, I don’t intend to sell these brands on Walmartstring
ALREADY_SELLING_ON_WALMARTI am already selling these items on Walmartstring
ITEM_NOT_PROFITABLEAs a seller, I cannot list rejected items due to profitability issuesstring
INVENTORY_NOT_AVAILABLEUpstream supply issues prevent sourcing this itemstring
HIGH_LOGISTICS_OR_FULFILLMENT_COSTHigh fulfillment or shipping cost makes this item unviable (incl. Low AUR)string
WRONG_PRODUCT_INFOData attached to the item is incorrect, missing, or mismatchedstring
OTHER_REASONOther reason for rejecting the items. customRejectionMessage is mandatory to pass if rejectionCode is OTHER_REASON.string
rejectionCodes*
string

Custom rejection message if the rejection code is OTHER_REASON. This is required only when the rejectionCodes has OTHER_REASON in the list. Maximum length of the message is 500

Headers
string
required

The access token retrieved in the Token API call

string

A unique ID to track the consumer request by channel. Use the Consumer Channel Type received during onboarding

string
required

A unique ID which identifies each API call and used to track and debug issues; use a random generated GUID for this ID

string
required

Walmart Service Name

string
required

Only supported Media Type : application/json

Response

Language
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json