Skip to main content
GET
Show Player

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

player
integer
required

Response

PlayerResource

id
integer
required

Unique identifier of the player. Stable across seasons, use it to reference the player from your own data.

self
string
required

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

name
string
required

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

short_name
string
required

Short display name, usually the surname.

url
string | null
required

Public player profile. null when the player has no profile page.

photo_url
string | null
required

Public URL of the player's photo. null when no photo is available.

category
enum<string>
required

Competition category the player competes in. Players never appear in both.

Available options:
men,
women
nationality
string
required

ISO 3166-1 alpha-2 country code, uppercase. Reflects the country the player represents, which can differ from birthplace.

ranking
string
required

Current position in the official ranking. null for unranked players.

points
integer
required

Points backing the official ranking position. null for unranked players. Use GET /players/{player}/rankings for the historical series.

elo
integer | null
required

Strength rating relative to the rest of the field, updated after every completed match. Every player enters the system at 1000. See the Elo rating guide for how it is calculated and how to read it.

height
integer | null
required

Height in centimetres. null when not available.

side
null | enum<string>
required

Side of the court the player covers. drive is the forehand side, backhand the other one. null when the player has no established side.

Available options:
drive,
backhand
hand
null | enum<string>
required

Dominant hand. null when not available.

Available options:
left,
right
birthplace
string | null
required

City or region the player was born in. null when not available.

birthdate
string | null
required

Date of birth, as YYYY-MM-DD. null when not available.

age
string | null
required

Age in years derived from birthdate. null when the birthdate is not available.

External profile URLs for the player. null when none are available.

updated_at
string
required

ISO 8601 timestamp of the last change to any field of this player, including ranking and Elo. Use it to skip records you have already processed.

connections
object
required

Related endpoints for this player.