v1
latestOpenAPI 3.1.02026-07-22123157.1 KBLive Leaderboard API
Returns the live leaderboard for a tournament in the live state: the leaderboard details, the top entries, and optionally a specific player's rank with one entry above and one below. Rate limit: 1200 requests per minute, per tournament.
get/v2/tournaments/{tournament_id}/leaderboard
Path parameters
tournament_idstring required
The tournament to fetch the live leaderboard for.
Query parameters
puidstring
The player's unique identifier — the same puid value you append to the game URL when sending that user to the tournament. If provided, the response includes that player's current rank with one entry above and one below.
limitinteger
Number of top entries to return. Defaults to 20. Maximum 100.
Response
Live leaderboard for the tournament.