Your referred teams, credits and tiers
const url = 'https://foxleague.ai/api/referral/rewards';const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url https://foxleague.ai/api/referral/rewards \ --header 'Authorization: Bearer <token>'Answers the teams that registered with your invitations, each with its progress (matches_played of matches_required, counted live: a match counts once its result is public, so a tournament match counts only after its broadcast ended), its deadline and the reward promised to you when it qualifies; the in-game credits you earned (a Recover All credit per qualified friend; the XP booster and Common pack tiers, each once ever) with whether the app can use them now; and where you stand on each tier.
A friend’s match counts when it is one that moves ELO: a ranked match the friend started against a real opponent, a Silver or Gold tournament match, a paid Bronze tournament match that is public (or private while rules.private_bronze_earns is on). A tournament match counts on either side. A ranked match another team started and the friend was drawn into, a casual game, a match of a free tournament, a forfeit, a match the ELO pair cap stopped (it moved no ELO: elo_pair_capped_nth on the match), a match against you and a match outside the friend’s window do not count.
Who: a signed-in player with a team.
Refusals: none.
Authorizations
Section titled “Authorizations ”Responses
Section titled “ Responses ”Success or a refusal: read success (the refusals are in the description).
object
A machine-readable reason next to error, set only where the caller must act differently. tx_pending: the payment was not refused but could not be verified yet; keep the transaction hash and confirm again with the same hash, never pay twice.
The answer. Present when success is true.
object
Your credits, oldest first, used ones included.
One in-game credit you earned.
object
The friend whose qualification earned it. null for a tier credit.
When you earned it (RFC 3339, UTC).
The credit id (POST /api/referral/credits/{id}/use).
recover_all (your squad’s players below full condition back to 100), xp_booster (the shop’s XP booster, started when you use it) or common_pack (five Common players from the pool, delivered to your wallet).
When you used it (RFC 3339, UTC). null while unused.
true when you can use it now: it is unused.
Free ranked tickets you get when a friend who registers now qualifies.
Matches a friend who registers now must play to qualify.
The teams that registered with your invitations, oldest first.
A team that registered with one of your invitations.
object
The end of the window (RFC 3339, UTC).
Free ranked tickets you get when this friend qualifies, fixed when the team registered.
Qualifying matches played so far, counted once each result is public.
Matches this friend must play, fixed when the team registered.
When the friend qualified (RFC 3339, UTC). null otherwise.
true when a Recover All credit is part of your reward for this friend.
The referral’s id.
When the friend’s team registered (RFC 3339, UTC).
pending (still counting), qualified (your reward was granted) or expired (the window ended first).
The friend’s team name.
Free ranked tickets the programme granted you so far.
The XP booster and Common pack tiers.
A tier reward and where you stand on it.
object
Qualified friends needed.
true once the tier fired. Each tier fires once per team, ever.
xp_booster or common_pack.
Your qualified friends so far.
Days a friend who registers now has to play them.
Why the request was refused, in plain words. Present when success is false.
true when the request did what it asked. false is a refusal: read error.
Example
{ "success": true, "data": { "referred": [ { "referral_id": 12, "team": "Steaua Nordului", "status": "pending", "matches_played": 3, "matches_required": 5, "registered_at": "2026-11-14T09:12:00Z", "deadline": "2026-12-14T09:12:00Z", "qualified_at": null, "inviter_tickets": 5, "recover_all": true } ], "credits": [ { "id": 4, "kind": "recover_all", "granted_at": "2026-11-20T18:00:00Z", "redeemed_at": null, "friend_team": "FC Vultur", "usable": true }, { "id": 7, "kind": "common_pack", "granted_at": "2026-11-28T18:00:00Z", "redeemed_at": null, "friend_team": null, "usable": true } ], "tiers": [ { "kind": "xp_booster", "at_friends": 3, "qualified_friends": 1, "granted": false }, { "kind": "common_pack", "at_friends": 5, "qualified_friends": 1, "granted": false } ], "tickets_granted": 5, "matches_required": 5, "window_days": 30, "inviter_tickets": 5 }}No valid session. The body is plain text: Missing Authorization header, Invalid Authorization format, Invalid session token or Session expired or invalid. Sign in again.
Example
Session expired or invalidA database read failed. The body is empty.