PadelRank API

REST API for verified padel doubles ratings. Your app sends HTTP requests; PadelRank returns skill scores, rankings, predictions, and accepts match results.

Base URL

All endpoints live under https://api.padelrank.me/v1. Responses are JSON. Timestamps are ISO 8601 UTC.

What you can build

  • Show a PadelRank score on player profiles in your booking app
  • Rank club members by skill with geo filters
  • Balance teams before friendly matches with the predict endpoint
  • Push match results so ratings stay current across your user base

Typical integration flow

  1. Create a partner account and subscribe
  2. Generate a live API key in the dashboard
  3. Register players (or reference existing usernames)
  4. Read ratings in your UI; submit matches after play

Endpoint map

GET  /v1/players/{username}     — player profile + rating
GET  /v1/players/search?q=        — prefix search
GET  /v1/rankings                 — leaderboard
POST /v1/intelligence/predict     — 4-player balance
POST /v1/players                  — register player
POST /v1/matches                  — submit 2v2 result
POST /v1/external-ratings/upsert  — import external priors