Request a promotions report
Sellers can use the on-request promotions report to view all active and future promotions that are set up with advance price information within a timeframe. The report provides information about promotional prices, including a start and end date for a promotional price to be active for an item and other information.
You can use the Promotions Report API to process and download the zipped CSV file. The report contains only promotional prices with status: Activated, Deactivated, Updated or Created.
OPTIONAL: Use an app to parse the CSV file
Instead of downloading the CSV file, you can use an app to parse the CSV file for you, you can use the Java code shown in the Pre-generated Reports guide. See Parse reports CSV file with Java.
What’s in the report file
The downloaded zip file provides the .csv file with the following information about your item promotions:
| Field | Description | Origin |
|---|---|---|
| SKU | Unique ID of the product | Seller |
| Item ID | Numeric identifier that uniquely identifies the item | Walmart |
| Product Name | Name of the product | Seller |
| Product Category | Category of the product | Walmart |
| Promo ID | Unique ID of the promotion | Walmart |
| Promo Effective Date | The date the promotion begins | Seller |
| Promo Expiration Date | The date the promotion ends | Seller |
| Current Price | Promotion Price of the product | Seller |
| Current Price Currency | Currency of the promotion price of the product | Seller |
| Comparison Price | Base price of the product without promotion | Seller |
| Comparison Price Currency | Currency of the base price of the product | Seller |
| Promotion Type | Possible values are: Clearance, Reduced, or Base | Seller |
| Promotion Status | Status of the promotion. Possible values are: Created, Updated, Activated, or Deactivated. | Walmart |
Updated about 2 months ago