Your pending League + Knockout invitations

GET

/api/tournaments/invitations

const url = 'https://foxleague.ai/api/tournaments/invitations';
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/tournaments/invitations \
  --header 'Authorization: Bearer <token>'

Lists your pending invitations to League + Knockout tournaments that still take entries, the soonest expiry first. Accept one by joining the tournament with POST /api/tournaments/{id}/join before expires_at, paying the entry fee on a paid tier. On a paid tier can_accept is false until your wallet is on the contract’s invite list, which follows within a minute of the invitation. seats_lock_at is the moment from which an accepted team can no longer leave.

Who: a signed-in player.

Refusals:

Not registered: the wallet has no player account.

Authorizations

session

Responses

200

Success or a refusal: read success (the refusals are in the description).

application/json

object

code

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.

string | null

data

The answer. Present when success is true.

Array<object>

One of your pending invitations.

object

can_accept

required

true when you can accept it now. On a paid tier it is false until your wallet is on the contract’s invite list. It is false while refusal is set.

boolean

entry_fee_foxsy

required

The entry fee in whole FOXSY. 0 on Bronze.

integer format: int64

expires_at

required

Accept before this moment.

string format: date-time

prize_atomic

The prize from FoxLeague held in the contract for this tournament, in atomic FOXSY. null when none is held.

string | null

refusal

Why it cannot be accepted now: the sentence the join would answer while your team has a seat or an invitation in another League + Knockout tournament that is not over (one at a time). null otherwise.

string | null

seats_lock_at

required

From this moment an accepted team cannot leave.

string format: date-time

tier

required

bronze, silver or gold.

string

title

required

The tournament’s title.

string

tournament_id

required

The tournament id.

integer format: int64

wave

required

The wave that sent it, 1 to 3.

integer format: int32

error

Why the request was refused, in plain words. Present when success is false.

string | null

success

required

true when the request did what it asked. false is a refusal: read error.

boolean

Example

{
  "data": [
    {
      "can_accept": true,
      "entry_fee_foxsy": 10000,
      "expires_at": "2026-11-05T18:00:00Z",
      "seats_lock_at": "2026-11-07T18:00:00Z",
      "tier": "gold",
      "title": "Champions Cup",
      "tournament_id": 602,
      "wave": 1,
      "prize_atomic": "100000000000000000000000"
    }
  ],
  "success": true
}

401

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.

text/plain

string

Example

Session expired or invalid