---
title: "Get an organization's leaderboard rank"
method: GET
path: "/leaderboards/organizations/{identifier}/rank"
tags: ["Leaderboards"]
---

# Get an organization's leaderboard rank

`GET /leaderboards/organizations/{identifier}/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.

## Path parameters

- `identifier` string, required — Organization slug or Convex organization ID.

## Query parameters

- `sortBy` 'wins' | 'winRate' | 'experience' — Supported leaderboard sort field.
- `gameSlug` string

## Response `200`

Organization rank.

- LeaderboardRankResponse — Leaderboard rank lookup response.
  - `id` string, required — Resolved entity ID.
  - `rank` integer, nullable, required
  - `sortBy` 'wins' | 'winRate' | 'experience', required — Supported leaderboard sort field.
  - `gameSlug` string, nullable
  - `timestamp` string, required

## Other responses

- `400` — Bad request (invalid body, cursor, limit, or date).
- `401` — Missing or invalid API key.
- `403` — API key lacks the required permission.
- `404` — Resource not found.
- `429` — Rate limited.
- `500` — Internal server error.

---

[API](https://skmtc.net/teambattles/apis/teambattles-api.md) · [All operations](https://skmtc.net/teambattles/apis/teambattles-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/teambattles/teambattles-api/revisions/2ffe8fb53b7d/schema)