Skip to main content

Get leaderboard page (legacy)

GET 
/leaderboards/:leaderboard_slug

Legacy paginated rankings without pagination metadata. Prefer GET /{leaderboard_slug}/entries for new integrations.

Request​

Responses​

Successful Response

Query parameters​

  • league (optional, string): league slug to filter leaderboard entries
  • limit (optional, int, default 100, range 1..1000): number of entries to return
  • offset (optional, int, default 0, min 0): pagination offset

Response example (200 OK)​

{
  "leaderboard_id": 12,
  "leaderboard_slug": "daily-elo",
  "leaderboard_name": "Daily ELO",
  "sort_order": "desc",
  "league": "gold",
  "expired": false,
  "entries": [
    {
      "rank": 1,
      "user_id": 101,
      "stat_value": 9800.0
    }
  ]
}

cURL example​

curl -X GET "http://localhost:8000/client/leaderboards/daily-elo?league=gold&limit=50&offset=0" \
  -H "x-client-id: <your-client-id>" \
  -H "x-client-secret: <your-client-secret>" \
  -H "Authorization: Bearer <access-token>"