---
title: "Players in a Rank Range"
method: GET
path: "/leaderboard-statistics/brand/{brandId}/leaderboard/{leaderboardId}/rank-range"
tags: ["Leaderboard Statistics"]
---

# Players in a Rank Range

`GET /leaderboard-statistics/brand/{brandId}/leaderboard/{leaderboardId}/rank-range`

Returns players in the given inclusive rank range. Use for pagination, or to show "players around me".

## Path parameters

- `brandId` string, uuid, required
- `leaderboardId` string, required

## Query parameters

- `rankFrom` integer, required
- `rankTo` integer, required

## Response `200`

Ranked players in the requested range.

- RankedPlayer[]
  - `playerId` string
  - `playerName` string, nullable — Display name at the time of last score update. `null` if not set.
  - `rank` integer — Player's current position (1 = first place).
  - `score` integer — Player's accumulated score on this leaderboard.

## Other responses

- `400` — Invalid request body or parameters.

---

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