MCTIERS · DEVELOPERS

Public API

Read Minecraft PvP rankings, player profiles, and tier history.

GET/api/stats

Overall player, placement, and game mode totals.

GET/api/gamemodes

Available game modes and ranked player counts.

GET/api/leaderboard?page=1&limit=25&sort=desc

Overall player leaderboard, ordered by points.

GET/api/rankings/{gamemode}?page=1&limit=25&tier=HT1

Rankings for a game mode. Replace {gamemode} with its slug; the tier filter is optional.

GET/api/players/search?q=username-or-uuid

Find players by Minecraft username or UUID.

GET/api/players/{uuid}

Player profile and overall ranking. Replace {uuid} with a Minecraft UUID.

GET/api/players/{uuid}/tiers

A player's current game mode tiers.

GET/api/players/{uuid}/history

A player's recorded tier history.

Public data endpoints return JSON. Invalid query parameters return HTTP 400; temporary data service errors return HTTP 503.