Skip to main content

​
Prerequisites

Before you begin, make sure you have:

​
Step 1: Get Your API Token

  1. Log in to your Padel API account
  2. Navigate to API Tokens
  3. Click Create Token and give it a descriptive name
  4. Copy your token and store it securely—you won’t be able to see it again
Keep your API token secret. Never share it publicly or commit it to version control.

​
Step 2: Make Your First Request

Let’s fetch the list of available seasons. This is a simple endpoint that returns all padel seasons available in the API. 
curl -X GET \
  'https://padelapi.org/api/seasons' \
  -H 'Authorization: Bearer YOUR_API_TOKEN'

​
Step 3: Explore the Response

A successful response returns a JSON array with season data: 
{
  "data": [
    {
      "id": 5,
      "self": "/api/seasons/5",
      "name": "Premier Padel 2026",
      "tournaments_count": 28,
      "status": "upcoming",
      "start_date": "2026-02-09",
      "end_date": "2026-12-13",
      "year": 2026,
      "connections": {
        "tournaments": "/api/seasons/5/tournaments"
      }
    },
    {
      "id": 3,
      "self": "/api/seasons/3",
      "name": "Padel FIP 2025",
      "tournaments_count": 40,
      "status": "finished",
      "start_date": "2025-02-08",
      "end_date": "2025-12-14",
      "year": 2025,
      "connections": {
        "tournaments": "/api/seasons/3/tournaments"
      }
    }
  ],
  "links": {
    "first": "https://padelapi.org/api/seasons?page=1",
    "last": "https://padelapi.org/api/seasons?page=1",
    "prev": null,
    "next": null
  },
  "meta": {
    "current_page": 1,
    "last_page": 1,
    "per_page": 15,
    "total": 6
  }
}

​
Step 4: Fetch Player Rankings

Now let’s try something more interesting—fetching the current player rankings: 
curl -X GET \
  'https://padelapi.org/api/rankings?category=male' \
  -H 'Authorization: Bearer YOUR_API_TOKEN'
You can filter rankings by category (male or female) and paginate results using the page and per_page parameters.

​
Next Steps

You’ve successfully made your first Padel API calls. Here’s what you can explore next:

API Reference

Explore all available endpoints and their parameters

Tournament Data

Learn about tournament coverage and data availability

​
Need Help?

If you run into any issues or have questions: