Skip to main content
Some catalog products include promotion fields when a time-limited offer applies. These fields are omitted when no promotion is active for the product.

​
Fields

​
promotion
boolean
true when the product has an active or upcoming promotion.
​
promotionType
string
The kind of offer: Discount, Value Off, or Added Value.
​
promotionDetails
string
Human-readable detail for the offer — for example 5 (percent or amount off) or a description of added value such as free item.
​
promotionStartDate
date
First day the promotion applies (YYYY-MM-DD).
​
promotionEndDate
date
Last day the promotion applies (YYYY-MM-DD).

​
Examples by type

promotionTypeExample promotionDetailsMeaning
Discount55% off the selling price
Value Off5Fixed amount off (same currency as the product)
Added Valuefree itemBonus content or bundle item included

​
Example product excerpt

{
  "id": 2,
  "name": "Sony PlayStation®Network Wallet Top-Up £100",
  "price": 10000,
  "currencyCode": "GBP",
  "promotion": true,
  "promotionType": "Discount",
  "promotionDetails": "5",
  "promotionStartDate": "2026-07-20",
  "promotionEndDate": "2026-07-30"
}
Promotions affect catalog display and pricing visibility only. Always send the current catalog price when placing an order — see Order lifecycle.