Skip to main content
GET
List Player Rankings

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

Start date of the historical series in YYYY-MM-DD format.

before_date
string<date> | null

End date of the historical series in YYYY-MM-DD format.

type
enum<string> | null

Filter by ranking type. Omit to return official, race and elo.

Available options:
official,
race,
elo

Response

id
integer
required

Unique identifier of the ranked player.

self
string
required

Path to the player's profile, relative to https://padelapi.org.

name
string
required

Full name of the player, without accents or special characters.

category
enum<string>
required

Competition category this ranking belongs to. Men and women are ranked separately, so positions repeat across categories.

Available options:
men,
women
nationality
string
required

ISO 3166-1 alpha-2 country code of the player, uppercase.

type
enum<string>
required

Which ranking list this entry belongs to. A player has one entry per type, so filter on this field when plotting a single series. The ranking and points on the player resource mirror the current official values. On the elo list points is the rating the player carried into that week, so it can differ from the elo on the player resource, which moves with every match played. Only players with at least 5 rated matches in the last 12 months are ranked on this list.

Available options:
official,
race,
elo
ranking
required

Position in the ranking. On the free plan, only a player's current entry is visible; older snapshots return hidden_free_plan. Paid plans include the full ranking history.

ranking_diff
required

Positions gained or lost since the player's previous entry. A player missing from the preceding snapshots re-enters with no movement, instead of a diff spanning the whole absence. On the free plan, only a player's current entry is visible; older snapshots return hidden_free_plan.

points
required

Ranking points, or the Elo rating when type is elo. On the free plan, only a player's current entry is visible; older snapshots return hidden_free_plan. Paid plans include the full ranking history.

points_diff
required

Points, or Elo rating points, gained or lost since the player's previous entry. A player missing from the preceding snapshots re-enters with no movement, instead of a diff spanning the whole absence. On the free plan, only a player's current entry is visible; older snapshots return hidden_free_plan.

date
string
required

Monday of the ISO week this snapshot belongs to, as YYYY-MM-DD. Snapshots are weekly, so this is the date the entry took effect rather than the day it was published.

connections
object
required

Related endpoints for this ranking entry.