POST
/
api
/
waitlist
/
v2
/
rewards
/
redeem
{
  "rewardId": "rwd_early_access"
}

{
  "success": true,
  "data": {
    "redemption": {
      "id": "red_123456",
      "rewardId": "rwd_early_access",
      "redeemedAt": "2024-01-15T10:00:00Z",
      "status": "pending"
    },
    "newBalance": 2500
  }
}

​
Body

​
rewardId
string
required
The ID of the reward to redeem

​
Response

​
redemption
object
The redemption record
​
newBalance
number
Updated Ganntium balance after redemption
{
  "rewardId": "rwd_early_access"
}

{
  "success": true,
  "data": {
    "redemption": {
      "id": "red_123456",
      "rewardId": "rwd_early_access",
      "redeemedAt": "2024-01-15T10:00:00Z",
      "status": "pending"
    },
    "newBalance": 2500
  }
}
Redemption will fail if:
  • User has insufficient Ganntium balance
  • Reward is out of stock
  • Reward is no longer available

Authorizations

​
Authorization
string
header
required

Dynamic authentication JWT token

Body

application/json
​
rewardId
string<uuid>
required

Response

Reward redeemed successfully

​
success
boolean
required
Example:

true

​
data
object