Reject Recommendations

put

https://marketplace.walmartapis.com/v3/growth/assortment/recommendations/rejections

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

Market availability: US | CA | MX

Body Params

Request payload

recommendationType

string

enum

required

Market availability: US | CA | MX

Attribute	Description	Data Type
ITEM	To reject list of recommended items	string

Allowed:

filterCriteria

object

Different type of filters can be passed in this object.
Market availability: US | CA | MX

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
Market availability: US | CA | MX

itemRecommendationUniqueIds

rejectionCodes

array of strings

enum

required

List of rejection codes.
Market availability: US, CA, MX

Attribute	Description	Data Type
NOT_SELLING_THESE_ITEMS Market availability: US, CA, MX	As a seller, I don’t intend to sell these items on Walmart	string
NOT_SELLING_THESE_BRANDS Market availability: US, CA, MX	As a seller, I don’t intend to sell these brands on Walmart	string
NOT_SELLING_THESE_CATEGORIES Market availability: US only	As a seller, I don’t intend to sell these categories on Walmart	string
LIMITED_TO_OTHER_MARKETPLACE Market availability: US, CA, MX	As a seller, I intend to sell the rejected items only on other marketplaces	string
ALREADY_SELLING_ON_WALMART Market availability: US, CA, MX	I am already selling these items on Walmart	string
OTHER_REASON Market availability: US, CA, MX	Other reason for rejecting the items. customRejectionMessage is mandatory to pass if rejectionCode is OTHER_REASON.	string

rejectionCodes*

Allowed:

customRejectionMessage

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.
Market availability: US | CA | MX

Headers

WM_GLOBAL_VERSION

string

enum

required

GLOBAL VERSION DEFAULT AS 3.1.
Market availability: Global

Allowed:

WM_SEC.ACCESS_TOKEN

string

required

Access token obtained from the Token API. Required for authenticating requests to Walmart Marketplace APIs.
Market availability: Global

WM_CONSUMER.CHANNEL.TYPE

string

A unique ID to identify the consumer request by channel. Use the Consumer Channel Type received during onboarding.
Market availability: Global

WM_QOS.CORRELATION_ID

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
Market availability: Global

WM_SVC.NAME

string

required

Walmart Service Name
Market availability: Global

WM_MARKET

string

enum

required

Identifies the Walmart Marketplace region for the request. If not specified, US is used by default.
Market availability: Global

Allowed:

Responses

200Successful Operation

400Bad Request - Invalid Input

403Forbidden - Unsupported Market

500System Error