Skip to content

API v1

Play the docs like a match.

REST + JSON for verified padel doubles ratings. Send players and results. Get scores, fair courts, and coaching fields you can bind in a UI — nothing about how ratings are calculated.

Base URL

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

Base
https://api.padelrank.me/v1

What you can build

GETPlayers

Profiles, cards, progress, and H2H.

Starter+

GET · POSTRosters

Private club and coach groups.

Read: Starter · write: Pro

POSTMatches

Single results, batch nights, recaps.

Pro+

POSTPredict & pair

Balance a 2v2 or deal a whole roster.

Pro+

GETCoach analysis

Scoreboard patterns from the matches you stored.

Pro+

GETRankings

Public leaderboard by PadelRank score.

Starter+

Typical rally

  1. Create a partner account and subscribe (Starter or Pro)
  2. Generate a live API key in the dashboard — scopes match your plan
  3. Starter: look up public players. Pro: register private amateurs and submit matches
  4. Stay under your monthly request cap; 429 when you exceed it

Plans are enforced on every request. See Authentication. Next: the five-minute quickstart — tick the boxes as you go.