Skip to main content
GET
/
players
/
{player}
/
rankings
List Player Rankings
curl --request GET \
  --url https://padelapi.org/api/players/{player}/rankings \
  --header 'Authorization: Bearer <token>'
[
  {
    "id": 123,
    "self": "<string>",
    "name": "<string>",
    "category": "<string>",
    "nationality": "<string>",
    "type": "<string>",
    "ranking": 123,
    "ranking_diff": 123,
    "points": 123,
    "points_diff": 123,
    "date": "<string>",
    "connections": {
      "rankings": "<string>"
    }
  }
]

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
​
self
string
required
​
name
string
required
​
category
string
required
​
nationality
string
required
​
type
string
required
​
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
​
connections
object
required