Skip to content

Count your unread notifications

GET
/api/notifications/unread-count
curl --request GET \
--url https://foxleague.ai/api/notifications/unread-count \
--header 'Authorization: Bearer <token>'

Answers how many of your notifications are unread. It answers 0 when the count cannot be read.

Who: a signed-in player.

Refusals: none.

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

Media type 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.

object
count
required

Unread notifications.

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": {
"count": 3
},
"success": true
}

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.

Media type text/plain
string
Example
Session expired or invalid