Redemptions

Retrieve redemption history, if any, for a given wallet_address.

get

Invoke this endpoint to return an array of rewards that were redeemed while associated with a specified wallet address.

Authorizations

Path parameters

wallet_addressanyrequired

the wallet address

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '/wallets/{wallet_address}/redemptions' \
  --header 'X-API-Key: YOUR_API_KEY'

200

200

{
  "redemptions": [
    {
      "date": 1,
      "token_id": "text",
      "description": "text",
      "code": "text"
    }
  ]
}

OK

Generate a redemption code for a given reward by providing the wallet_address, token_id, and reward_id.

post

Utilize this endpoint to generate a redemption code for a given reward.

Authorizations

Path parameters

wallet_addressanyrequired

the wallet address

Body

reward_idstringrequired

the reward uuid

token_idstringrequired

the token id

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url '/wallets/{wallet_address}/redemptions' \
  --header 'X-API-Key: YOUR_API_KEY' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data 'reward_id=text&token_id=text'

200

401

404

200

{
  "redemption": {
    "uuid": "text",
    "code": "text",
    "promo_code": "text",
    "state": "text",
    "expires_at": 1
  }
}

OK