Skip to main content
GET
Show Player Form

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 measure the form in YYYY-MM-DD format. Defaults to 180 days before before_date.

before_date
string<date> | null

Date before to measure the form in YYYY-MM-DD format. Defaults to today.

level
string

Tournament level(s) to scope the form. 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 form (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

PlayerFormResource

id
integer
required

Unique identifier of the player this form belongs to.

self
string
required

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

from
string
required

First day of the window the form is measured over, as YYYY-MM-DD. Set by after_date, or a recent window by default.

to
string
required

Last day of the window, as YYYY-MM-DD. Set by before_date, or today by default. windows end on this day.

expected_win_rate
number | null
required

Win rate the player's pairs were expected to reach over the window, 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 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 player is over-performing. null when there are too few matches for the gap to mean anything.

matches_played
integer
required

Matches behind the numbers above, qualification included.

by_period
object[]
required

The same values by calendar month within the window, oldest first. Months without matches 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
windows
object
required

Overlapping windows of 7, 30 and 90 days ending on to, each with the same values. They ignore after_date, so they are available whatever the window.

same_period_last_year
object
required

The same values over the window shifted one year back, to compare the player against themselves.

streak
object
required

Current run of consecutive results up to to. result is won or lost (null when there are no matches) and matches its length.

third_sets
object
required

Deciding sets won and lost within the window. Retirements are left out, since the third set was not completed.

tiebreaks
object
required

Sets settled 7-6 won and lost within the window.

connections
object
required

Related endpoints for this form.