User Scores | Leaderboards API Reference

POST /api/leaderboards/user.php

Authorization: AppID:AppKey or user session token

Request body

Field	Type	Required	Description
app_id	string	required	App to query
leaderboard_id	int	optional	Filter to a specific leaderboard

Identify the user (when auth is AppID:AppKey — one of)

Field	Type	Description
user_id	int	Numeric user ID
userkey	string	User's `userKey`
token	string	User's session token

When authenticated with a user token in the header, returns that user's own scores with no additional fields required.

Test this endpoint

Headers

Authorization *

Body

app_id *

user_id or token

leaderboard_id

Success response 200

{
  "success": true,
  "user_id": 42,
  "app_id": "com.myapp.game",
  "count": 2,
  "scores": [
    {
      "leaderboard_id": 1,
      "slug": "goals",
      "name": "Top Scorers",
      "points_name": "Goals",
      "score": 47,
      "updated_at": "2026-05-29 15:00:00"
    },
    {
      "leaderboard_id": 2,
      "slug": "assists",
      "name": "Most Assists",
      "points_name": "Assists",
      "score": 12,
      "updated_at": "2026-05-29 14:30:00"
    }
  ]
}