Skip to main content
GET
Show Pair Stats

Authorizations

Authorization
string
header
required

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

Path Parameters

player1
integer
required

The player1 ID

player2
integer
required

The player2 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

PairStatsResource

id
string
required

Identifier of the pair, as the two player ids joined by a hyphen (e.g. 65-66).

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 pair has ever played together.

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 pair'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 together, over the pair's whole history regardless of coverage.

finals
integer
required

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

semifinals
integer | null
required

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.

best_round
integer | null
required

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.

connections
object
required

Related endpoints for these stats.