---
title: "Get the API key owner's player rank"
method: GET
path: "/leaderboards/players/me/rank"
tags: ["Leaderboards"]
---

# Get the API key owner's player rank

`GET /leaderboards/players/me/rank`

Returns the API key owner's own rank in the global player leaderboard (the principal is ranked, so there is no identifier path param, unlike the team and organization rank endpoints). Sort with sortBy (wins, winRate, or experience; default wins). rank is null when the owner has no completed matches, has a private profile, is currently banned, or ranks beyond the bounded best-effort scan window (about 2000 entries). gameSlug is not supported and returns 400. Requires users.profile:read.

## Query parameters

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

## Response `200`

Player 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.
- `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)