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 both official and race.

Available options:
official,
race

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.

Available options:
official,
race
ranking
required

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.

ranking_diff
required

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.

points
required

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_diff
required

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.

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.