--- updatedAt: 2026-04-23T19:00:11.000Z --- # 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 [block:html] { "html": "\n \n" } [/block] # OpenAPI definition ```json { "openapi": "3.0.1", "info": { "title": "Assortment Recommendations Overview", "version": "1.0", "description": "Assortment recommendations help sellers understand customer demand in Walmart and the external market by providing personalized item recommendations. These insights are generated by leveraging demand signals like: \n* Internal and external search \n* Best Sellers\n* Trending items\n\n The assortment recommendations API can be used to view Customer Favorites (In-demand items), demand trends, filter, reject, and bulk download the recommendations. These recommended items can be set up using the [Item Setup API](https://developer.walmart.com/api/us/mp/items).\nSellers need to provide API access key on [developer portal](https://developer.walmart.com/account/generateKey) for ‘Analytics & Growth’ to solution providers and channel partners to be able to access Assortment Growth APIs." }, "x-readme": { "samples-languages": [ "shell" ], "proxy-enabled": false }, "servers": [ { "url": "https://marketplace.walmartapis.com", "description": "Production URL" }, { "url": "https://sandbox.walmartapis.com", "description": "Sandbox URL" } ], "paths": { "/v3/growth/assortment/recommendations/rejections": { "put": { "tags": [ "Assortment Recommendations" ], "summary": "Reject Recommendations", "description": "You can reject a list of recommendations that are recommended for you. \n \nUsing ITEM as a recommendationType,\n* You can reject specific item recommendations using the filterCriteria or by providing the list of itemRecommendationUniqueIds. \n* 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 \n\n\n", "externalDocs": { "description": "View Guide", "url": "/doc/us/us-mp/us-mp-assortmentrecommendations/#12965" }, "operationId": "rejectAssortmentRecommendations", "parameters": [ { "in": "header", "name": "WM_SEC.ACCESS_TOKEN", "description": "The access token retrieved in the Token API call", "required": true, "schema": { "type": "string" }, "example": "eyJraWQiOiIzZjVhYTFmNS1hYWE5LTQzM....." }, { "in": "header", "name": "WM_CONSUMER.CHANNEL.TYPE", "description": "A unique ID to track the consumer request by channel. Use the Consumer Channel Type received during onboarding", "required": false, "schema": { "type": "string" } }, { "in": "header", "name": "WM_QOS.CORRELATION_ID", "description": "A unique ID which identifies each API call and used to track and debug issues; use a random generated GUID for this ID", "required": true, "schema": { "type": "string" }, "example": "b3261d2d-028a-4ef7-8602-633c23200af6" }, { "in": "header", "name": "WM_SVC.NAME", "description": "Walmart Service Name", "required": true, "schema": { "type": "string" }, "example": "Walmart Service Name" }, { "in": "header", "name": "Accept", "description": "Only supported Media Type : application/json", "required": true, "schema": { "type": "string" }, "example": "application/json" } ], "requestBody": { "description": "Request payload", "content": { "application/json": { "schema": { "required": [ "recommendationType", "rejectionCodes" ], "type": "object", "properties": { "recommendationType": { "type": "string", "description": "| Attribute | Description | Data Type |\n| --- | ----------- | ------- |\n| ITEM | To reject list of recommended items | string |", "enum": [ "ITEM" ] }, "filterCriteria": { "type": "object", "properties": { "searchText": { "minLength": 3, "type": "string", "description": "To filter with a search text having a word that can be part of the recommended data. " }, "multiValueFilter": { "type": "array", "description": "Filters based on multiple values associated with a specific parameter. \nNo parameter should be repeated.", "items": { "required": [ "parameter" ], "type": "object", "properties": { "parameter": { "type": "string", "description": "| Attribute | Description | Data Type |\n| --- | ----------- | ------- |\n| BRAND | To filter based on list of brands which are associated with the assortment recommendations | string |\n| CATEGORY | To filter based on list of categories which are associated with the assortment recommendations | string |\n| PRODUCT_TYPE | To filter based on list of product types which are associated with the assortment recommendations | string |", "enum": [ "BRAND", "CATEGORY", "PRODUCT_TYPE" ] }, "values": { "type": "array", "description": "A list of values corresponds to the parameter in the filter. The values in the list should not be null or blank. Maximum size of the list should be 7.", "items": { "type": "string", "description": "A list of values corresponds to the parameter in the filter. The values in the list should not be null or blank. Maximum size of the list should be 7." } } }, "description": "Filters based on multiple values associated with a specific parameter. \nNo parameter should be repeated." } }, "enumFilter": { "type": "array", "description": "Filter based on preset parameters and their associated values is possible with EnumFilter. \nNo parameter should be repeated.", "items": { "type": "object", "properties": { "parameter": { "type": "string", "description": "To apply an enum filter based on the predefined parameter. \n\n| Attribute | Description | Data Type |\n| --- | ----------- | ------- |\n| ITEM_AVAILABILITY_STATUS | To filter based on whether the items which are new to Walmart or existing in Walmart. | string |\n| SHOPPING_TRENDS | Indicates the demand types identified in the market for an item. An item can have more than one value for this parameter. | string |\n| DEMAND_SALES_TRENDS | Indicates the months of the year when high demand is observed for the recommended item. | string |", "enum": [ "ITEM_AVAILABILITY_STATUS", "SHOPPING_TRENDS", "DEMAND_SALES_TRENDS" ] }, "values": { "type": "array", "description": "Values correspond to the parameter for applying filter on the response. The data in values[] are predefined. OR operator is used between the values. \n\n| Attribute | Associated parameter of enumFilter | Description | Data Type |\n| --- | ----------- | ----------- | ------- |\n| EXISTING_IN_WALMART | ITEM_AVAILABILITY_STATUS | To filters based on the items which are existing in Walmart. | string |\n| NEW_TO_WALMART | ITEM_AVAILABILITY_STATUS | To filters based on the items which are new to Walmart. | string |\n| MOST_SEARCHED_FOR | SHOPPING_TRENDS | Item is most searched for in the market. | string |\n| BEST_SELLERS | SHOPPING_TRENDS | Item is best seller in the market. | string |\n| DEAL_ITEMS | SHOPPING_TRENDS | Item is in demand and is a part of deals in the other marketplaces. | string |\n| JAN, FEB, MAR, APR, MAY, JUN, JUL, AUG, SEP, OCT, NOV, DEC | DEMAND_SALES_TRENDS | Indicates the months of the year when high demand is observed for the recommended item. | string |\n", "items": { "type": "string", "description": "Values correspond to the parameter for applying filter on the response. The data in values[] are predefined. OR operator is used between the values. \n\n| Attribute | Associated parameter of enumFilter | Description | Data Type |\n| --- | ----------- | ----------- | ------- |\n| EXISTING_IN_WALMART | ITEM_AVAILABILITY_STATUS | To filters based on the items which are existing in Walmart. | string |\n| NEW_TO_WALMART | ITEM_AVAILABILITY_STATUS | To filters based on the items which are new to Walmart. | string |\n| MOST_SEARCHED_FOR | SHOPPING_TRENDS | Item is most searched for in the market. | string |\n| BEST_SELLERS | SHOPPING_TRENDS | Item is best seller in the market. | string |\n| DEAL_ITEMS | SHOPPING_TRENDS | Item is in demand and is a part of deals in the other marketplaces. | string |\n| JAN, FEB, MAR, APR, MAY, JUN, JUL, AUG, SEP, OCT, NOV, DEC | DEMAND_SALES_TRENDS | Indicates the months of the year when high demand is observed for the recommended item. | string |\n", "enum": [ "EXISTING_IN_WALMART", "NEW_TO_WALMART", "MOST_SEARCHED_FOR", "BEST_SELLERS", "DEAL_ITEMS", "JAN", "FEB", "MAR", "APR", "MAY", "JUN", "JUL", "AUG", "SEP", "OCT", "NOV", "DEC" ] }, "enum": [ "EXISTING_IN_WALMART", "NEW_TO_WALMART", "MOST_SEARCHED_FOR", "BEST_SELLERS", "DEAL_ITEMS", "JAN", "FEB", "MAR", "APR", "MAY", "JUN", "JUL", "AUG", "SEP", "OCT", "NOV", "DEC" ] } }, "description": "Filter based on preset parameters and their associated values is possible with EnumFilter. \nNo parameter should be repeated." } }, "rangeFilter": { "type": "array", "description": "Filter based on a range with RangeFilter. You must also pass a parameter along with any of the beginning or the ending points or both. \nNo parameter should be repeated.", "items": { "type": "object", "properties": { "parameter": { "type": "string", "description": "To apply a range filter based on the predefined parameter. \n\n| Attribute | Description | Data Type |\n| --- | ----------- | ------- |\n| PRICE | To filter based on the price. | string |", "enum": [ "PRICE" ] }, "from": { "type": "string", "description": "Filter range start" }, "to": { "type": "string", "description": "Filter range end" } }, "description": "Filter based on a range with RangeFilter. You must also pass a parameter along with any of the beginning or the ending points or both. \nNo parameter should be repeated." } }, "isTopGoGetItem": { "type": "boolean", "description": "Filters the Top Go-Get Items, which are high-demand, customer-favorite items that sellers should prioritize adding to their Walmart catalog. Set to `true` to return only Top Go-Get Items." }, "isNewRecommendation": { "type": "boolean", "description": "Filter for newly added recommendations. These are high-demand, customer-favorite items added to the recommendation set within the past 30 days. Set to `true` to return only these items." } }, "description": "Different type of filters can be passed in this object." }, "itemRecommendationUniqueIds": { "type": "array", "description": "List of item recommendation unique ids to reject. \nThe size of the list should not exceed 100. \nYou cannot add filter criteria along with the itemRecommendationUniqueIds list", "items": { "type": "string", "description": "List of item recommendation unique ids to reject. \nThe size of the list should not exceed 100. \nYou cannot add filter criteria along with the itemRecommendationUniqueIds list" } }, "rejectionCodes": { "type": "array", "description": "List of rejection codes\n\n| Attribute | Description | Data Type |\n| --- | ----------- | ------- |\n| ITEM_DISCONTINUED | As a seller, I have discontinued this SKU or stopped carrying this product line | string |\n| NOT_SELLING_THESE_ITEMS | As a seller, I don’t intend to sell these items on Walmart | string |\n| ITEM_SEASONAL_OR_NOT_RELEVANT | Item is out-of-season or not needed at this time | string |\n| COMPETITOR_ITEM | As a seller, I already carry similar items, thus adding more isn't helpful | string |\n| NOT_SELLING_THESE_CATEGORIES | As a seller, I don’t intend to sell these categories on Walmart | string |\n| NOT_AUTHORIZED | As a seller, I lack the required brand permission/authorization | string |\n| LIMITED_TO_OTHER_MARKETPLACE | As a seller, I intend to sell the rejected items only on other marketplaces | string |\n| NOT_SELLING_THESE_BRANDS | As a seller, I don’t intend to sell these brands on Walmart | string |\n| ALREADY_SELLING_ON_WALMART | I am already selling these items on Walmart | string |\n| ITEM_NOT_PROFITABLE | As a seller, I cannot list rejected items due to profitability issues | string |\n| INVENTORY_NOT_AVAILABLE | Upstream supply issues prevent sourcing this item | string |\n| HIGH_LOGISTICS_OR_FULFILLMENT_COST | High fulfillment or shipping cost makes this item unviable (incl. Low AUR) | string |\n| WRONG_PRODUCT_INFO | Data attached to the item is incorrect, missing, or mismatched | string |\n| OTHER_REASON | Other reason for rejecting the items. `customRejectionMessage` is mandatory to pass if `rejectionCode` is `OTHER_REASON`. | string |\n", "items": { "type": "string", "description": "List of rejection codes \n\n| Attribute | Description | Data Type |\n| --- | ----------- | ------- |\n| NOT_SELLING_THESE_ITEMS | As a seller, I don’t intend to sell these items on Walmart | string |\n| NOT_SELLING_THESE_BRANDS | As a seller, I don’t intend to sell these brands on Walmart | string |\n| NOT_SELLING_THESE_CATEGORIES | As a seller, I don’t intend to sell these categories on Walmart | string |\n| LIMITED_TO_OTHER_MARKETPLACE | As a seller, I intend to sell the rejected items only on other marketplaces | string |\n| ALREADY_SELLING_ON_WALMART | I am already selling these items on Walmart | string |\n| OTHER_REASON | Other reason for rejecting the items. customRejectionMessage is mandatory to pass if rejectionCode is OTHER_REASON. | string |", "enum": [ "ITEM_DISCONTINUED", "NOT_SELLING_THESE_ITEMS", "ITEM_SEASONAL_OR_NOT_RELEVANT", "COMPETITOR_ITEM", "NOT_SELLING_THESE_CATEGORIES", "NOT_AUTHORIZED", "LIMITED_TO_OTHER_MARKETPLACE", "NOT_SELLING_THESE_BRANDS", "ALREADY_SELLING_ON_WALMART", "ITEM_NOT_PROFITABLE", "INVENTORY_NOT_AVAILABLE", "HIGH_LOGISTICS_OR_FULFILLMENT_COST", "WRONG_PRODUCT_INFO", "OTHER_REASON" ] }, "enum": [ "ITEM_DISCONTINUED", "NOT_SELLING_THESE_ITEMS", "ITEM_SEASONAL_OR_NOT_RELEVANT", "COMPETITOR_ITEM", "NOT_SELLING_THESE_CATEGORIES", "NOT_AUTHORIZED", "LIMITED_TO_OTHER_MARKETPLACE", "NOT_SELLING_THESE_BRANDS", "ALREADY_SELLING_ON_WALMART", "ITEM_NOT_PROFITABLE", "INVENTORY_NOT_AVAILABLE", "HIGH_LOGISTICS_OR_FULFILLMENT_COS", "WRONG_PRODUCT_INFO", "OTHER_REASON" ] }, "customRejectionMessage": { "type": "string", "description": "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" } } }, "examples": { "Reject item recommendations based on filters": { "value": { "recommendationType": "ITEM", "filterCriteria": { "multiValueFilter": [ { "parameter": "BRAND", "values": [ "Disney", "NINTENDO" ] }, { "parameter": "CATEGORY", "values": [ "Toys" ] }, { "parameter": "PRODUCT_TYPE", "values": [ "Action Figure Sets", "Power Tool Batteries", "Action Figures" ] } ], "enumFilter": [ { "parameter": "ITEM_AVAILABILITY_STATUS", "values": [ "NEW_TO_WALMART", "EXISTING_IN_WALMART" ] }, { "parameter": "SHOPPING_TRENDS", "values": [ "MOST_SEARCHED_FOR", "BEST_SELLERS", "DEAL_ITEMS" ] }, { "parameter": "DEMAND_SALES_TRENDS", "values": [ "DEC", "APR", "NOV", "MAR" ] } ], "rangeFilter": [ { "parameter": "PRICE", "to": 3 } ] }, "rejectionCodes": [ "NOT_SELLING_THESE_ITEMS", "OTHER_REASON" ], "customRejectionMessage": "Removal of this item from other marketplace is in progress" } }, "Reject item recommendations based on unique identifier": { "value": { "recommendationType": "ITEM", "itemRecommendationUniqueIds": [ "000166eb-7e67-4a20-96f0-9242db499q1c", "47044c4f-ccb0-4b4e-8f05-20d34209fd13" ], "rejectionCodes": [ "NOT_SELLING_THESE_ITEMS" ] } } } } }, "required": true }, "responses": { "200": { "description": "Successful Operation", "content": { "application/json": { "schema": { "type": "object", "properties": { "payload": { "type": "object", "properties": { "message": { "type": "string", "description": "Message confirming the rejection of the recommendations." } }, "description": "Payload in the response for rejecting recommendations." } } }, "example": { "payload": { "message": "The selected items will be removed shortly from the recommendations." } } } } } } } } } } ```