Skip to main content
GET
/
players
List Players
curl --request GET \
  --url https://padelapi.org/api/players \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": 123,
      "self": "<string>",
      "name": "<string>",
      "short_name": "<string>",
      "url": "<string>",
      "photo_url": "<string>",
      "category": "<string>",
      "ranking": "<string>",
      "points": 123,
      "height": 123,
      "nationality": "<string>",
      "birthplace": "<string>",
      "birthdate": "<string>",
      "age": "<string>",
      "hand": "left",
      "side": "<string>",
      "links": "<string>",
      "updated_at": "<string>",
      "connections": {
        "matches": "<string>",
        "pairs": "<string>",
        "stats": "<string>"
      }
    }
  ],
  "links": {
    "first": "<string>",
    "last": "<string>",
    "prev": "<string>",
    "next": "<string>"
  },
  "meta": {
    "current_page": 123,
    "from": 123,
    "last_page": 123,
    "links": [
      {
        "url": "<string>",
        "label": "<string>",
        "active": true
      }
    ],
    "path": "<string>",
    "per_page": 123,
    "to": 123,
    "total": 123
  }
}

Documentation Index

Fetch the complete documentation index at: https://padelapi.org/docs/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

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

Query Parameters

​
name
string | null

Name of the player to search for. To search for multiple players, separate names with commas.

​
nationality
string | null

2 letters country-code of the player.

Required string length: 2
​
category
enum<string> | null

Category of the player. Either men or women.

Available options:
men,
women
​
birthplace
string | null

Name of the birthplace of the player.

​
side
enum<string> | null

Side of the player, either drive or backhand.

Available options:
drive,
backhand
​
updated_after
string<date-time> | null

Filter players updated after this datetime in ISO 8601 format.

​
updated_before
string<date-time> | null

Filter players updated before this datetime in ISO 8601 format.

​
sort_by
enum<string> | null

Name of the parameter to sort the tournaments by.

Available options:
name,
ranking,
points,
height,
birthdate,
updated_at
​
order_by
enum<string> | null

Order of the sorting, either asc or desc.

Available options:
asc,
desc

Response

Paginated set of PlayerResource

​
data
PlayerResource · object[]
required
​
links
object
required
​
meta
object
required