Skip to main content
POST
POST /referrer-claim

Claim Rewards

Claims all available rewards for a referrer. Returns platform-specific promo codes that the referrer can redeem.

Request

string
required
Unique identifier for the referrer (same as used in /referrer)

Example Request

Response

string
Success message indicating number of rewards claimed
array
Array of claimed reward codes

Example Response

Usage in Mobile App

Error Responses

When to Call This Endpoint

1

Check Progress First

Call /referrer to see if rewards are available
2

Show Claim Button

If rewards_earned > 0, show a “Claim Rewards” button
3

Claim on User Action

Call /referrer-claim when user taps the button
4

Display Codes

Show all claimed codes with copy buttons

Best Practices

Only show “Claim Rewards” button when rewards are actually available
Display all claimed codes clearly with copy buttons
Provide direct links to App Store/Play Store redemption pages
Show celebration UI (confetti, animation) when rewards are claimed
Don’t auto-claim rewards - let users explicitly claim them for better UX

Multiple Rewards

If a referrer has earned multiple rewards (e.g., reached 5 referrals twice), the response will include multiple codes:
Display all codes and allow users to copy each one individually.