Skip to main content

Get entries

GET 
/leaderboards/:leaderboard_slug/entries

Paginated leaderboard rankings with metadata. Requires x-client-id, x-client-secret, and Authorization bearer token. Caller must have client.leaderboard permission.

Request​

Responses​

Successful Response

Query parameters​

  • league (optional, string): league slug filter
  • limit (optional, int, default 100, range 1..1000): page size
  • offset (optional, int, default 0): pagination offset
  • expand (optional): set to profile to attach profile snippets

When league is omitted and leagues are enabled, each row includes a per-player league slug inferred from stat bands or AT_RESET assignment.

Response example (200 OK)​

{
  "pagination": {
    "limit": 50,
    "offset": 0,
    "total": 237,
    "has_more": true
  },
  "league": "gold",
  "entries": [
    {
      "rank": 1,
      "user_id": 101,
      "stat_value": 9800.0,
      "league": "gold",
      "profile": null
    }
  ]
}

cURL example​

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