Partner Rankings API

The VolleyLens Partner Rankings API allows authorized partners to retrieve youth volleyball team rankings for display on their websites or applications.

Base URL

https://tcojnvbhqlyabuwudwdg.supabase.co/functions/v1/partner-rankings

Authentication

Include a Bearer token in the Authorization header. Contact us for API access.

Query Parameters

ParameterTypeRequiredDescription
genderstringYesmale or female
age_groupstringNo10-18 or all (default: all)
seasonintegerNoEnd year of season (default: 2026)
searchstringNoSearch by team name (2-100 chars)
pageintegerNoPage number (default: 1)

Example Request

GET /partner-rankings?gender=male GET /partner-rankings?gender=female&age_group=16&page=2

Response Fields

FieldDescription
data[].rankTeam rank position
data[].team_nameTeam name
data[].winsTotal wins
data[].lossesTotal losses
data[].elo_ratingCurrent Elo rating
data[].team_urlLink to team page (may be null)
pagination.totalTotal teams matching query
pagination.total_pagesTotal pages available

Error Codes

CodeDescription
400Missing or invalid parameter
401Missing or invalid auth token
405Non-GET request
500Server error

Notes

  • Rankings sorted by Elo rating with win percentage tiebreaker
  • 50 teams per page
  • Season parameter is the end year (e.g., 2026 for 2025-2026)
  • Search is case-insensitive partial match

Attribution

Please include a visible attribution link: Rankings powered by VolleyLens.com