Skip to main content

Get current player's rank and league

GET 
/leaderboards/:leaderboard_slug/me

Returns the current authenticated player's rank data for the requested leaderboard slug. Requires x-client-id, x-client-secret, and Authorization bearer token. Caller must have client.leaderboard permission.

Request​

Responses​

Successful Response

Response example (200 OK)​

{
  "leaderboard_id": 12,
  "leaderboard_slug": "daily-elo",
  "leaderboard_name": "Daily ELO",
  "user_id": 101,
  "rank": 24,
  "stat_value": 3120.0,
  "league": "silver",
  "expired": false
}

rank, stat_value, and league can be null when the player has no leaderboard entry yet.

cURL example​

curl -X GET "http://localhost:8000/client/leaderboards/daily-elo/me" \
  -H "x-client-id: <your-client-id>" \
  -H "x-client-secret: <your-client-secret>" \
  -H "Authorization: Bearer <access-token>"