Retrieve price incentives data

Retrieves a comprehensive list of all price incentives available for items in your catalog.

The response includes detailed information such as Item ID, Product Name, Product URL, SKU ID, Target Price, current Price, Incentive Type, Incentive Status, Base referral fee, Reduced Referral Fee, Enrollment Type, Inventory count, Enrollment Date (epoch Timestamp), Expiration date (epoch timestamp), Start date (epoch timestamp), and Incentive ID.

For Walmart-funded items, the Target Price, Expiration Date, Start Date, Incentive ID, Reduced Referral Fee, and Enrollment Type will not be displayed (null values). Additionally, Enrollment Type and Date will not be shown for items eligible for Reduced Referral Fee incentives.

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

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
int32
Defaults to 25

Specifies the number of items to return. Allowed range is 1 to 200. Default is 25.

int32
Defaults to 0

Specifies the offset of item list to be returned. Minimum offset value is 0.

string
enum
Defaults to EXPIRATION_DATE

Specifies the sort criteria for items.

Allowed:
string
enum
Defaults to DESC

Specifies the sort order for given sort criteria.

Allowed:
string
enum

Specifies the incentive type to filter the incentive items.

Allowed:
string
enum
required
Defaults to ELIGIBLE

Specifies the incentive status to retrieve items with ELIGIBLE or ENROLLED incentives.

Allowed:
Headers
string
required

Access token obtained from the Token API. This is required for authenticating requests to Walmart Marketplace APIs.

string

A unique ID to track the consumer request by channel. Use the Consumer Channel Type received during onboarding.

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.

string
required

Specifies the name of the Walmart service being called.

Response

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