Skip to content

Rosters

Partner-owned groups of amateur members or coach students. This is how a club app keeps a private directory, a leaderboard, and coaching headlines without making every player public.

POST /v1/rosters

Plan: Requires Pro or Enterprise. Starter receives HTTP 403 plan_forbidden.

Scope: write:players. kind is club, coach, league, or custom. Slug is unique per partner.

cURL
curl -s -X POST "https://api.padelrank.me/v1/rosters" \
    -H "Authorization: Bearer $PADELRANK_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{ "slug": "weeknight-amateurs", "name": "Weeknight amateurs", "kind": "club" }'

GET /v1/rosters and GET /v1/rosters/{slug}

List every roster for your partner, or one roster by slug with member_count. Scope: read:players.

POST /v1/rosters/{slug}/members

Add a player (or a coach) by username or profile id.

cURL
curl -s -X POST "https://api.padelrank.me/v1/rosters/weeknight-amateurs/members" \
    -H "Authorization: Bearer $PADELRANK_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{ "username": "maria_s", "role": "player" }'

Private profiles you created can be rostered and then read on player, analysis, and progress endpoints. You cannot add another partner's private amateur to your roster.

DELETE /v1/rosters/{slug}/members

Remove a member. Body or query: username or profile_id.

cURL
curl -s -X DELETE "https://api.padelrank.me/v1/rosters/weeknight-amateurs/members" \
    -H "Authorization: Bearer $PADELRANK_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{ "username": "maria_s" }'

GET /v1/rosters/{slug}/board

Scope: read:players. Ranked member list with PadelRank score and confidence — the club TV / coach whiteboard payload.

cURL
curl -s "https://api.padelrank.me/v1/rosters/weeknight-amateurs/board" \
    -H "Authorization: Bearer $PADELRANK_API_KEY"

GET /v1/rosters/{slug}/analysis

Scope: read:intelligence. Cohort view: average consistency, who is improving, who needs attention (focus fade, deciding-set drop-off, and similar).

cURL
curl -s "https://api.padelrank.me/v1/rosters/weeknight-amateurs/analysis" \
    -H "Authorization: Bearer $PADELRANK_API_KEY"