Quickstart

Go from zero to your first API call in about five minutes.

1. Get credentials

Sign up as a partner, complete billing, then open API keys and create a live key. Copy it once — we only store a hash.

2. Set your environment

export PADELRANK_API_KEY="pr_live_..."

3. Register a test player

curl -s -X POST "https://api.padelrank.me/v1/players" \
  -H "Authorization: Bearer $PADELRANK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "username": "maria_s",
    "display_name": "Maria Silva",
    "country_code": "PT"
  }'

Response includes id (UUID) and username.

4. Read the rating

curl -s "https://api.padelrank.me/v1/players/maria_s" \
  -H "Authorization: Bearer $PADELRANK_API_KEY"

New players start at the default skill prior. padelrank_score increases as they win verified matches.

5. Submit a match (Pro+)

After four players exist, post a result your platform witnessed:

curl -s -X POST "https://api.padelrank.me/v1/matches" \
  -H "Authorization: Bearer $PADELRANK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "external_ref": "your-app-match-9821",
    "played_at": "2026-06-16T18:30:00Z",
    "winning_team": "A",
    "trust_tier": "partner_attested",
    "participants": [
      { "username": "maria_s", "team": "A", "court_position": "left" },
      { "username": "joao_p", "team": "A", "court_position": "right" },
      { "username": "ana_r", "team": "B", "court_position": "left" },
      { "username": "pedro_l", "team": "B", "court_position": "right" }
    ]
  }'