Skip to main content
GET
Live Leaderboard API
Tournaments module is only available with paid plans. Contact us to know more.

About this API

Returns the live leaderboard for a tournament in progress. This API is only available while the tournament is in the live state. Optionally pass a puid to get that player’s current rank alongside the top entries.

player object behaviour

The rate limit on this API (1200 requests per minute) is counted per tournament, not per token. If you fan out to many users, fetch the leaderboard once into your own backend or CDN and serve it from there. Do not proxy every end-user request straight through to this API.

API specification

Authorizations

Authorization
string
header
required

You can find the Bearer token for this API under Settings & Admin > API Tokens within the Gamezop Business Dashboard.

Path Parameters

tournament_id
string
required

The tournament to fetch the live leaderboard for.

Query Parameters

puid
string

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.

limit
integer
default:20

Number of top entries to return. Defaults to 20. Maximum 100.

Required range: x <= 100

Response

Live leaderboard for the tournament.

success
boolean
data
object