Skip to main content

​
Claim Gift Code

POST /gift/claim

Redeems a gift code to add funds to the user’s account balance. Requires reCAPTCHA verification.
POST /gift/claim
Authentication: connected, recaptcha Body Parameters
​
code
string
required
The gift code to redeem. Can include hyphens (they are automatically removed). Must be 20 or 25 characters long (after removing hyphens).
Response 
{
  "status": "success",
  "data": {
    "message": "Gift code claimed successfully",
    "amount": "50.00",
    "amount_raw": 5000,
    "type": "funds"
  }
}
FieldTypeDescription
messagestringSuccess confirmation message
amountstringFormatted amount added (in dollars)
amount_rawintegerRaw amount added (in cents)
typestringGift code type (currently only "funds")
Errors
StatusMessage
errorMissing code parameter
errorInvalid gift code
errorInvalid gift code or already used
Gift codes are single-use. Once claimed, they cannot be reused.