Skip to main content
GET
Show Pair Synergy

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 measure the synergy in YYYY-MM-DD format.

before_date
string<date> | null

Date before to measure the synergy in YYYY-MM-DD format.

level
string

Tournament level(s) to scope the synergy. Accepts one or multiple comma-separated values (e.g. major,p1,p2 for all Premier Padel matches) or repeated parameters (e.g. level[]=major&level[]=p1).

round
enum<integer> | null

Round of the match to measure the synergy (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

PairSynergyResource

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.

expected_win_rate
number | null
required

Win rate the pair was expected to reach together, as a percentage rounded to two decimals, from the Elo ratings of all four players at the time of each match. null when no matches are counted.

actual_win_rate
number | null
required

Win rate actually achieved together over the same matches, as a percentage rounded to two decimals. null when no matches are counted.

delta
number | null
required

actual_win_rate minus expected_win_rate, in percentage points. Positive means the pair beats the sum of its parts. null when there are too few matches for the gap to mean anything.

matches_played
integer
required

Matches together behind the numbers above, qualification included.

by_period
object[]
required

The same values by calendar quarter, oldest first, so a partnership can be seen settling in or wearing out. Quarters without matches together are left out.

trend
null | enum<string>
required

Direction of delta across by_period. null when too few periods have a delta to tell.

Available options:
rising,
stable,
declining
connections
object
required

Related endpoints for this synergy.