Promotions guide

What this resource is for

Promotions are the active offers on brands. They can include enhanced commission, increased cashback or time-limited deals. For gift card publishers, each promotion carries the promotion-id you use to buy a card.

When to use it

• Show current offers to customers.
• Find the promotion-id needed for a gift card purchase.
• Filter offers by date window.

Important implementation notes

• Promotion availability can change independently of brand availability.
• Refresh regularly, and do not build screens from a stale copy.
• Results are paginated at 100 per page. Follow the next link.
• The promotion-id is the value to send as promo_id in paymentLink and giftCardRequestApi.

 
curl "https://staging-api.spendstream.io/v2/getPromotionsList?page=1" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "User-Agent: YourApp/1.0"

Common mistakes

• Using the brand-id where a promotion-id is required.
• Using the older getPromotions endpoint. It is deprecated and has no v2 route, so use getPromotionsList.
• Forgetting that an offer may have expired since you last fetched it.

Related resources

• Brands
• Gift Cards
• Payments
• Cashback

Endpoint reference

The v2 endpoint for this resource is getPromotionsList. Exact parameters, schemas and responses are in the API reference.