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

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

Sample request

This sample request shows how to update the price for a single item.

curl --request POST \ --url https://marketplace.walmartapis.com/v3/price \ --header 'WM_QOS.CORRELATION_ID: Correlation_ID' \ --header 'WM_SEC.ACCESS_TOKEN: Access_Token' \ --header 'WM_GLOBAL_VERSION: 3.1' \ --header 'WM_MARKET: ca' \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data '
{ "MPItemFeedHeader": { "mart": "WALMART_CA", "locale": "en", "version": "5.0.20250801-18_47_55-api", "businessUnit": "WALMART_CA", "tenant": "WALMART_CA" }
}
'

import requests url = "https://marketplace.walmartapis.com/v3/price"
headers = { "WM_QOS.CORRELATION_ID": "Correlation_ID", "WM_SEC.ACCESS_TOKEN": "Access_Token", "WM_GLOBAL_VERSION": "3.1", "WM_MARKET": "ca", "Content-Type": "application/json", "Accept": "application/json",
} body = { "MPItemFeedHeader": { "mart": "WALMART_CA", "locale": "en", "version": "5.0.20250801-18_47_55-api", "businessUnit": "WALMART_CA", "tenant": "WALMART_CA", }
} response = requests.post(url, headers=headers, json=body, timeout=30)
response.raise_for_status()
print(response.json())

Modify your code

• Use a unique WM_QOS.CORRELATION_ID for each request.
• Replace WM_SEC.ACCESS_TOKEN with your valid access token obtained through authentication.

Sample response

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

{ "feedStatus": "PROCESSED", "feedSubmissionDate": 1761819871277, "itemsReceived": 1, "itemsSucceeded": 1, "itemsFailed": 0, "itemsProcessing": 0, "itemDetails": { "itemIngestionStatus": [ { "martId": WALMART_CA, "sku": "sku_04463276028417", "ingestionStatus": "SUCCESS" } ] }
}

Result

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