Update pricing for multiple items in bulk

Updates prices and promotions in bulk for multiple items. You can modify the prices of multiple items in bulk using a price feed. This is useful for implementing pricing strategies across your catalog, such as seasonal discounts, competitive pricing adjustments, or clearance sales.

Each price feed can contain up to 10,000 items. To ensure optimal performance (feed processing time), we recommend limiting feeds to 1,000 items and keeping the payload under 10 MB.

Use this API instead of the single price update API when updating prices for multiple items. For newly created items, ensure that the Walmart Part ID (WPID) has been assigned and that at least 24 hours have passed since item creation before submitting a bulk price update feed. The bulk price update Service Level Agreement (SLA) is 15 minutes.

The price sequence guarantee is observed by the bulk price update functionality, subject to the following rules:

  • You may include the same Stock Keeping Unit (SKU) multiple times in a single feed. However, if a SKU is repeated in a feed, only one price will be applied.
  • The price sequence guarantee ensures that the latest price update, based on its creation timestamp, is the one that changes the item's price, overwriting the previous version.
  • Price updates received with an earlier timestamp are ignored. We recommend using UTC timestamps for the value of feedDate in all feed-based bulk updates.

After submitting the price feed, wait at least 5 minutes before checking whether the bulk price update was successful. If a price update fails, for example, due to duplicate SKU entries, an error response will be returned.

For more information and usage examples, refer to the Pricing API Guide.

Market availability: Global

Query Params
string
enum
required

The feed Type.
Market availability: Global

Allowed:
Body Params

The request body consists of a Feed file attached to the request based on the feedType selected .
Market availability: Global

MPItemFeedHeader
object


Market availability: Global

MPItem
Headers
string
required

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

string

A unique ID to identify the consumer request by channel.
Market availability: Global

string
required

A unique ID that identifies each API call and is used to track and debug issues. Use a randomly generated GUID for this ID.
Market availability: Global

string
required

Specifies the name of the Walmart service being called.
Market availability: Global

string
enum
required

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

Allowed:
string
enum
required

Indicates the global version of the API. The default is set to 3.1.
Market availability: Global

Allowed:
Responses

Language
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json