Show Pair Stats
Retrieve detailed performance statistics for a pair: win rate, sets won, and match analysis.
🔒 This endpoint requires a Pro subscription.
Read coverage first: it tells you which matches the performance metrics are
computed over. Palmarés always spans the pair’s whole history.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
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
PairStatsResource
Identifier of the pair, as the two player ids joined by a hyphen (e.g. 65-66).
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 pair has ever played together.
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 pair'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 together, over the pair's whole history regardless of coverage.
Finals reached together, over the pair's whole history regardless of coverage. Includes the ones won, so titles is always a subset.
Semifinals reached together, over the pair's whole history regardless of coverage. null when coverage is finals_only, since earlier rounds are not available to count.
Furthest stage the pair 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.