List Player Rankings
Retrieve every ranking published for a player — multiple types (official,
race) — as the current snapshot or as a historical series.
Without after_date/before_date it returns the latest entry for each ranking
type. With after_date and/or before_date it returns the chronological series
of weekly snapshots within that range, so you can plot ranking evolution and spot
peaks and lows.
On the free plan, only the latest weekly snapshot is visible: ranking values
from older snapshots return hidden_free_plan. Paid plans include the full
ranking history.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
The player ID
Query Parameters
Start date of the historical series in YYYY-MM-DD format.
End date of the historical series in YYYY-MM-DD format.
Filter by ranking type. Omit to return both official and race.
official, race Response
Unique identifier of the ranked player.
Path to the player's profile, relative to https://padelapi.org.
Full name of the player, without accents or special characters.
Competition category this ranking belongs to. Men and women are ranked separately, so positions repeat across categories.
men, women ISO 3166-1 alpha-2 country code of the player, uppercase.
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.
official, race Position in the ranking. On the free plan, only the latest weekly snapshot is visible; older snapshots return hidden_free_plan. Paid plans include the full ranking history.
Positions gained or lost since the previous weekly snapshot. On the free plan, only the latest weekly snapshot is visible; older snapshots return hidden_free_plan.
Ranking points. On the free plan, only the latest weekly snapshot is visible; older snapshots return hidden_free_plan. Paid plans include the full ranking history.
Points gained or lost since the previous weekly snapshot. On the free plan, only the latest weekly snapshot is visible; older snapshots return hidden_free_plan.
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.
Related endpoints for this ranking entry.