Players

Look up skill by username or register players your platform manages.

GET /v1/players/{username}

Returns public profile fields and computed rating. Private profiles → 404.

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

Example response shape:

{
  "id": "uuid",
  "username": "maria_s",
  "display_name": "Maria Silva",
  "country_code": "PT",
  "rating": {
    "padelrank_score": 2840,
    "confidence_level": "established",
    "confidence_label": "Medium confidence",
    "matches_played": 22
  }
}

GET /v1/players/search

Prefix search on public usernames. Query params: q (min 2 chars), limit (max 50).

curl -s "https://api.padelrank.me/v1/players/search?q=mar&limit=10" \
  -H "Authorization: Bearer $PADELRANK_API_KEY"

POST /v1/players

Idempotent registration by username. Scope: write:players.

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"
  }'