API referenceEndpointsRedemption
Prizes the wallet holds, has won, or has redeemed
GET
WalletSessionheader
AuthorizationBearer <token>Authorization: Bearer <accessToken> from POST /auth/verify. Proves control of
one wallet for one hour. Used only by the Redemption endpoints, from the browser.
Each prize carries redeemable, can_ship_now and redeem_blocked_reason. Use redeemable for shipping eligibility. Pre-minted items have no Keep Item or Mint action; can_ship_now is retained for compatibility. Prizes shipped together share the same redemption order. The quote/prepare endpoints recheck eligibility and wallet ownership.
application/json- response
success*booleandata*curl -X GET 'https://api-staging.theverity.xyz/api/v1/redeem/prizes' \ -H 'Authorization: Bearer <wallet_access_token>'Example Response
{ "success": true, "data": { "prizes": [ { "id": 0, "raffle_id": 0, "raffle_name": "string", "prize_item": { "name": "string", "description": "string", "category": "string", "market_value_usd": 0, "image_urls": [ "string" ] }, "won_at": "2019-08-24T14:15:22Z", "distributed_at": "2019-08-24T14:15:22Z", "distribution_status": "string", "mint_status": "pending", "mint_address": "string", "redeemable": true, "can_ship_now": true, "redeem_blocked_reason": "VALUE_EXCEEDS_LIMIT", "redemption": { "id": 0, "status": "string", "tracking_number": "string" }, "buyback": { "enabled": true, "rate_pct": 0, "amount_usd": 0, "deadline": "2019-08-24T14:15:22Z", "bought_back_at": "2019-08-24T14:15:22Z", "amount_paid_usd": 0, "eligible": true } } ] }}