Bulk update item status

Use the Bulk update item status API to bulk enroll and manage which items are participating in the Reviews Accelerator Program (RAP), helping to boost item visibility and credibility. You can also use this API to remove items from participating in the RAP, due to changed business strategy, item unavailability, or other reasons.

The API returns the list of items whose status is updated successfully with their Item ID, description, and SKU ID. It also returns a list of items whose status update failed due to some reason with the appropriate error code and description. Sellers can update status of maximum 100 items at once.

Note: This page describes an example using only the required parameters and inputs to bulk update item enrollment status in the RAP. For a full list of customization options and additional capabilities, refer to the
Walmart Reviews API reference guide.

How it works

• You submit a list of item IDs and the action to enroll/disenroll items from the RAP.
• You receive a success list with each item’s ID, description, and SKU, confirming enrollment/disenrollment. A failure section showing any items that couldn’t be enrolled and provides error details (such as invalid IDs).
• You can specify a custom target number of reviews to be collected for each item during enrollment. For legal compliance, the maximum allowed is 20 reviews. If you enter more than 20, the system will automatically adjust it to 20.

Endpoint

PUT https://marketplace.walmartapis.com/v3/growth/reviews-accelerator/items/status

Sample request

This example shows you how to set the necessary headers and structure your API call to update the status of specific items. It demonstrates how to include required headers such as content type and accept, and how to format the JSON payload to specify the action (like enrolling items) and the relevant item IDs. Use this sample as a starting point, then modify it with your actual data and any additional parameters as described in the API reference.

curl --request PUT \ --url https://marketplace.walmartapis.com/v3/growth/reviews-accelerator/items/status \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data '
{ "status": "ENROLL", "items": [ { "itemId": "2719243" }, { "itemId": "2719255" } ]
}
'

import requests
import json url = "https://marketplace.walmartapis.com/v3/growth/reviews-accelerator/items/status"
headers = { "accept": "application/json", "content-type": "application/json"
}
data = { "status": "ENROLL", "items": [ {"itemId": "2719243"}, {"itemId": "2719255"} ]
} response = requests.put(url, headers=headers, data=json.dumps(data))
print(response.status_code)
print(response.json())

This sample request disenrolls (removes) one or more items from Walmart’s RAP by the specified item IDs.

curl --request PUT \ --url https://marketplace.walmartapis.com/v3/growth/reviews-accelerator/items/status \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data '
{ "status": "DISENROLL", "items": [ { "itemId": "2719243" }, { "itemId": "2719255" } ]
}
'

import requests
import json url = "https://marketplace.walmartapis.com/v3/growth/reviews-accelerator/items/status"
headers = { "accept": "application/json", "content-type": "application/json"
}
data = { "status": "DISENROLL", "items": [ {"itemId": "2719243"}, {"itemId": "2719255"} ]
} response = requests.put(url, headers=headers, data=json.dumps(data))
print(response.status_code)
print(response.json())

Modify your code

• Replace the exampleitemId with the actual item ID you want to update.
• Change the status field to another valid status supported by the API. For example, you can change the status fromENROLL to DISENROLL.
• You can set the target number of reviews to collect per item during enrollment. Default is 5. Maximum allowed is 20.

Sample response

The following is a sample successful response provided by the API. The sample also includes response provided by the API on failures. The description and information might change based on the error.

{ "statusCode": 200, "payload": { "success": { "items": [ { "itemId": "2719243", "itemDescription": "View-Master Discovery Kids 3D Marine Life Toy Viewfinder Reel", "sku": "NK-WHT2XL" } ] }, "failure": { "items": [ { "itemId": "2719255", "errorCode": "400.INVALID_ITEMID.001", "errorDescription": "Invalid itemId", "severity": "ERROR", "category": "DATA" } ] } }
}

Result

If successful, the API responds with an HTTP status: 200 OK and a JSON payload containing a list of items successfully updated, including their itemId, itemDescription, and SKU. The response may also contain a list of items that failed to update, with details like itemId, errorCode, errorDescription, severity, and category.