Open 1v1 challenges aimed at you

GET

/api/notifications/challenges-for-me

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

Answers the open 1v1 challenges that name you as the opponent, newest first, one page at a time. The X-Total-Count response header holds how many there are in all; ask for the next page with offset set to the number of rows already read until you hold that many. Only challenges still open to accept are listed. A wallet without an account gets an empty list.

Who: a signed-in player.

Refusals:

Authorizations

session

Parameters

Query Parameters

limit

integer format: int64

Rows per page, 1 to 100. Default 20.

offset

integer format: int64

Rows to skip. Default 0.

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>

An open 1v1 challenge that names you as the opponent.

object

creator_team_name

required

The challenger’s team name; null when the challenger has no team.

string | null

creator_user_id

required

The challenger’s user id.

integer format: int32

deadline

required

When the challenge expires if you do not accept it (RFC 3339).

string format: date-time

entry_fee_foxsy

required

The entry fee in whole FOXSY.

integer format: int64

title

required

The challenge title.

string

tournament_id

required

The challenge’s tournament id.

integer format: int64

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": [
    {
      "creator_team_name": "Red Kites",
      "creator_user_id": 1093,
      "deadline": "2026-10-01T13:40:00+00:00",
      "entry_fee_foxsy": 500,
      "title": "Red Kites vs Fox Rovers",
      "tournament_id": 2231
    }
  ],
  "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