Statistics API — global, team, and player rankings

GET /statistics — season statistics and rankings

Returns global season statistics, five-team rankings across several categories, and top-five individual player leaderboards. When no season_id is given, the active season is used.Method: GET
Path: /statistics
Auth: None

Query parameters

season_id

number

Season to aggregate statistics for. Defaults to the active season.

Response

global

object

Aggregate match and card counts for the season.

Show properties

matchesPlayed

number

Number of finalised matches.

totalGoals

number

Total goals scored across all matches.

avgGoals

number

Average goals per match (rounded to 2 decimal places).

totalYellows

number

Total yellow cards across all teams.

totalReds

number

Total red cards across all teams.

totalCleanSheets

number

Number of matches in which at least one side kept a clean sheet.

teamRankings

object

Five ranked lists of teams, each containing up to 5 entries.

Show properties

mostWins

object[]

Teams ordered by wins descending. Each entry: id, name, logo_url, won, lost, drawn, goals_for, goals_against.

mostLosses

object[]

Teams ordered by losses descending.

mostDraws

object[]

Teams ordered by draws descending.

bestOffense

object[]

Teams ordered by goals scored descending.

bestDefense

object[]

Teams ordered by goals conceded ascending.

individualRankings

object

Top-5 player leaderboards.

Show properties

topScorers

object[]

Players with the most goals. Each entry: id, name, photo_url, team_name, value (goal count).

topYellowCards

object[]

Players with the most yellow cards. Same fields as topScorers, value = yellow card count. Only includes players with at least one yellow card.

topRedCards

object[]

Players with the most red cards. Same fields as topScorers, value = red card count. Only includes players with at least one red card.

Example

curl "https://api.futsalmanager.example/statistics?season_id=3"

Response

{
  "global": {
    "matchesPlayed": 48,
    "totalGoals": 312,
    "avgGoals": 6.5,
    "totalYellows": 87,
    "totalReds": 6,
    "totalCleanSheets": 14
  },
  "teamRankings": {
    "mostWins": [
      { "id": 7, "name": "Atlético Norte", "logo_url": "...", "won": 14, "lost": 2, "drawn": 2, "goals_for": 92, "goals_against": 41 }
    ],
    "mostLosses": [],
    "mostDraws": [],
    "bestOffense": [],
    "bestDefense": []
  },
  "individualRankings": {
    "topScorers": [
      { "id": 42, "name": "Marcos Ruiz", "photo_url": "...", "team_name": "Atlético Norte", "value": 22 }
    ],
    "topYellowCards": [],
    "topRedCards": []
  }
}

GET /statistics/user-ranking — top-10 users by porra points

Returns the global leaderboard of the top 10 users ranked by total porra (match-prediction) points. Ties are broken alphabetically by username.Method: GET
Path: /statistics/user-ranking
Auth: None

Response — `200 OK`

An array of up to 10 user objects:

number

User ID.

username

string

Username.

points

number

Total porra points accumulated.

Example

curl "https://api.futsalmanager.example/statistics/user-ranking"

Response

[
  { "id": 3, "username": "predictor_pro", "points": 145 },
  { "id": 11, "username": "futsal_fan_88", "points": 132 }
]

GET /statistics/user-stats — personal porra stats (auth required)

Returns the authenticated user’s total porra points, their current global rank, and a history of their last 20 match votes with outcomes.Method: GET
Path: /statistics/user-stats
Auth: JWT required

Response — `200 OK`

totalPoints

number

Total porra points earned by the user.

globalRank

number

User’s position in the global ranking (1-indexed).

history

object[]

Up to 20 most recent vote records, ordered by match date descending.

Show history entry properties

match_id

number

Match ID the vote relates to.

my_prediction

string

The user’s prediction: "local", "visitante", or "empate".

points_awarded

number

Points awarded for this vote (0 if incorrect or match not yet finalised).

home_team_name

string

Home team name.

away_team_name

string

Away team name.

home_goals

number | null

Home goals (null if match is pending).

away_goals

number | null

Away goals (null if match is pending).

status

string

Match status.

date

string

Match date.

real_result

string

"local", "visitante", "empate", or "pendiente" if the match has not finished.

Example

curl "https://api.futsalmanager.example/statistics/user-stats" \
  -H "Authorization: Bearer <token>"

Authentication

Matches

Teams & Players

Standings & Statistics

Admin

Statistics API — global, team, and player rankings

Query parameters

Response

Example

Response — `200 OK`

Example

Response — `200 OK`

Example

Build docs developers (and LLMs) love

Authentication

Matches

Teams & Players

Standings & Statistics

Admin

Documentation Index

​Query parameters

​Response

​Example

​Response — 200 OK

​Example

​Response — 200 OK

​Example

Build docs developers (and LLMs) love

Query parameters

Response

Example

Response — `200 OK`

Example

Response — `200 OK`

Example