Show Player Stats
Retrieve aggregated career and performance statistics for a professional padel player, computed in real time from every finished and retired match in the Padel API database. Use it to power player profiles, scouting tools, fantasy models and fan dashboards without crunching raw match data yourself.
🔒 This endpoint requires a Pro subscription.
The response covers win/loss record, set and game tallies, per-match averages and
tournament progression. Read coverage first: it tells you which matches the
performance metrics are computed over. Palmarés always spans the whole history.
The padel statistics guide
has worked examples and metric definitions.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
The player ID
Query Parameters
Date after to calculate the stats in YYYY-MM-DD format.
Date before to calculate the stats in YYYY-MM-DD format.
Tournament level(s) to scope the stats. Accepts one or multiple comma-separated values (e.g. major,p1,p2 for all Premier Padel matches).
Round of the match to calculate the stats (1 = Final, 2 = Semifinal, 4 = Quarterfinal, 8 = Round of 16, 16 = Round of 32, 32 = Round of 64)
1, 2, 4, 8, 16, 32 Response
PlayerStatsResource
Unique identifier of the player these stats belong to.
Path to this endpoint, relative to https://padelapi.org.
Basis of the performance metrics, so you know what the numbers below are computed over. full means complete draws are available for the whole history and every match counts. partial means only finals exist for the earliest period, so performance counts the matches with complete draws and excludes those older finals. finals_only means only finals are available (they predate complete-draw coverage, or round=1 was filtered), so performance is computed over them. null when there are no matches. Palmarés is unaffected: it always spans the whole history.
full, partial, finals_only Date of the earliest match included in the performance metrics, as YYYY-MM-DD. Anything before it is excluded per coverage. null when there are no matches.
Matches counted in the performance metrics. Limited by coverage, so it can be lower than the total number of matches the player has ever played.
Matches won out of matches_played.
Win rate as a percentage of matches_played, rounded to two decimals. null when no matches are counted.
Sets won across matches_played.
Sets lost across matches_played. Together with sets_won it gives the set balance.
Average sets played per match, counting both sides, rounded to two decimals. A proxy for how long the player's matches tend to run. null when no matches are counted.
Games won across matches_played.
Games lost across matches_played. Together with games_won it measures game-level dominance.
Average games played per match, counting both sides, rounded to two decimals. null when no matches are counted.
Tournaments won, over the player's whole history regardless of coverage.
Finals reached, over the player's whole history regardless of coverage. Includes the ones won, so titles is always a subset.
Semifinals reached, over the player's whole history regardless of coverage. null when coverage is finals_only, since earlier rounds are not available to count.
Furthest stage ever reached, in the same scale as a match round: 1 a final, 2 a semifinal, 4 a quarterfinal, and so on. Lower is better. null when there are no matches.
Related endpoints for these stats.