v20

OpenAPI 3.1.0raw.githubusercontent.com2026-08-011984401.2 MB
Leaderboards

Get an organization's leaderboard rank

Returns an organization's 1-based rank for the requested leaderboard filters, or null when the organization is unranked (no qualifying match activity for the filter). Resolve the org by slug or Convex organization ID. sortBy defaults to wins (also winRate, experience). Pass gameSlug to rank by that game's stats only; omit it for the global all-games rank. Organization stats are aggregated from the org's active, enabled, non-private teams. Ranking counts only public, active, non-disabled organizations with at least one match. Requires orgs.profile:read.

get/leaderboards/organizations/{identifier}/rank

Path parameters

identifierstring required

Organization slug or Convex organization ID.

Organization slug or Convex organization ID.

Query parameters

sortBy'wins' | 'winRate' | 'experience'

Supported leaderboard sort field.

gameSlugstring

Response

Organization rank.

idstring required

Resolved entity ID.

rankinteger nullable required
sortBy'wins' | 'winRate' | 'experience' required

Supported leaderboard sort field.

gameSlugstring nullable
timestampstring required