Skip to main content
GET
Show Player Stats

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

player
integer
required

The player ID

Query Parameters

after_date
string<date> | null

Date after to calculate the stats in YYYY-MM-DD format.

before_date
string<date> | null

Date before to calculate the stats in YYYY-MM-DD format.

level
string | null

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
enum<integer> | null

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)

Available options:
1,
2,
4,
8,
16,
32

Response

PlayerStatsResource

id
integer
required

Unique identifier of the player these stats belong to.

self
string
required

Path to this endpoint, relative to https://padelapi.org.

coverage
null | enum<string>
required

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.

Available options:
full,
partial,
finals_only
performance_since
string | null
required

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_played
integer
required

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
integer
required

Matches won out of matches_played.

win_percentage
number | null
required

Win rate as a percentage of matches_played, rounded to two decimals. null when no matches are counted.

sets_won
integer
required

Sets won across matches_played.

sets_lost
integer
required

Sets lost across matches_played. Together with sets_won it gives the set balance.

avg_sets_per_match
number | null
required

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
integer
required

Games won across matches_played.

games_lost
integer
required

Games lost across matches_played. Together with games_won it measures game-level dominance.

avg_games_per_match
number | null
required

Average games played per match, counting both sides, rounded to two decimals. null when no matches are counted.

titles
integer
required

Tournaments won, over the player's whole history regardless of coverage.

finals
integer
required

Finals reached, over the player's whole history regardless of coverage. Includes the ones won, so titles is always a subset.

semifinals
integer | null
required

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.

best_round
integer | null
required

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.

connections
object
required

Related endpoints for these stats.