This endpoint returns every reward in your program. Use it to show your catalog in your own website or app, or to find the id you need to redeem a reward.

Endpoint

GET https://api.jericommerce.com/v1/programs/{program_slug}/coupons/rewards-public

This endpoint is public, so it does not need an API key. If the program does not exist, it answers 404 with PROGRAM_NOT_FOUND.

Response

The response is an array of rewards:

[
  {
    "id": "2f6c1a2e-8f3b-4f0e-9a51-1d2b3c4d5e6f",
    "title": "10€ off your next order",
    "description": "Use it on any product.",
    "image": "https://...",
    "type": "fixed",
    "redeemCost": 500,
    "currencyPerPoint": null,
    "minPoints": null,
    "maxPoints": null,
    "order": 1,
    "visibilityRules": [],
    "redeemabilityRules": []
  }
]
Field Notes
id The reward ID. Send it as rewardId to redeem the reward.
title, description, image What the customer sees. description can be empty.
type fixed for a Fixed reward and dynamic for Points as cash in the admin.
redeemCost Fixed rewards only. The points the reward costs (its Points cost in the admin).
currencyPerPoint Points as cash only. How much money each point is worth.
minPoints, maxPoints Points as cash only. The minimum and maximum points a customer can use at once.
order The position of the reward in the catalog.
visibilityRules, redeemabilityRules The rules that decide who can see and redeem the reward.

This is the full catalog, not the rewards a specific customer can redeem right now. A reward in this list can still be rejected for a customer who doesn't meet its rules or doesn't have enough points.