Update pricing for a single item

Call this endpoint to update the price of a single item on Walmart Marketplace. This API is designed for quick price adjustments to individual products, making it ideal for real-time price changes or corrections. By using this API, you can specify a new price for the product, as well as an optional comparison price (MSRP or strikethrough price).

Note: This page describes an example using only the required parameters and inputs to update the price of a single item. For a full list of customization options and additional capabilities, refer to the Marketplace Pricing API Reference.

The price sequence guarantee is enforced for both synchronous (individual) and asynchronous (bulk or feed) updates. These different methods have different SLAs; there is no guarantee that price updates will be received in any particular order.

The price sequence guarantee ensures that the latest price update, based on its creation timestamp, is the one that changes the price of the item, overwriting the previous version. Price updates received with an earlier timestamp are ignored. As a result, we recommend all feed-based bulk updates base the value of feedDate on UTC.

Endpoint

PUT https://marketplace.walmartapis.com/v3/price

Sample request

This sample shows how to update the price for a single item. The request includes authentication headers, a correlation ID for tracking, and a JSON payload that identifies the item by its SKU. It sets a reduced price of $10 in USD for the SKU, using the currentPriceType field to indicate a promotional or discounted rate. This API is useful for making quick, individual pricing updates without the need for a batch feed.

curl --request PUT \ --url https://marketplace.walmartapis.com/v3/price \ --header 'WM_QOS.CORRELATION_ID: Correlation_ID' \ --header 'WM_SEC.ACCESS_TOKEN: Access_Token' \ --header 'WM_SVC.NAME: Walmart Service Name' \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data '
{ "sku": "SKU_Item", "pricing": [ { "currentPriceType": "REDUCED", "currentPrice": { "currency": "USD", "amount": 10 } } ]
}
'

import requests url = "https://marketplace.walmartapis.com/v3/price"
headers = { "WM_QOS.CORRELATION_ID": "Correlation_ID", "WM_SEC.ACCESS_TOKEN": "Access_Token", "WM_SVC.NAME": "Walmart Service Name", "accept": "application/json", "content-type": "application/json"
}
data = { "sku": "SKU_Item", "pricing": [ { "currentPriceType": "REDUCED", "currentPrice": { "currency": "USD", "amount": 10 } } ]
} response = requests.put(url, headers=headers, json=data) print(response.status_code)
print(response.json())

Modify your code

• Replace WM_SEC.ACCESS_TOKEN and WM_QOS.CORRELATION_ID with actual values.
• Replace SKU_Item in the request URL or parameters with the actual SKU of an item.
• Change currentPriceType to CLEARANCE.
• Update currentPrice to set a new selling price.
  • Change the currency to a different currency.
  • Change the amount to a different value.

Sample response

The sample response confirms that the price update for the specified SKU was successful.

{ "ItemPriceResponse": { "mart": "WALMART_US", "message": "Thank you. Your price has been updated. Please allow up to five minutes for this change to be reflected on the site.", "sku": "SKU_Item" }
}

Result

The response confirms that the price update for the specified SKU was successful. It also includes the marketplace identifier (WALMART_US) and the SKU of the item for which the price is changed.