Overview
GET/gamification/leaderboardgamification

Ranked leaderboard by summed points for a subject kind

List leaderboard.

Auth: bearerAuth — calls run as the authenticated user.

Parameters
  • subjectTypequery · optionalstring
  • periodquery · optional"all" | "week" | "month"
  • pagequery · optionalstring
  • pageSizequery · optionalstring
Responses
200

Paginated leaderboard

  • itemsGamificationLeaderboardEntry[]
  • totalinteger
  • pageinteger
  • pageSizeinteger
Example
{
  "items": [
    {
      "subjectType": "string",
      "subjectId": "string",
      "name": "string",
      "avatarUrl": "string",
      "totalPoints": 0,
      "level": "string"
    }
  ],
  "total": 0,
  "page": 0,
  "pageSize": 0
}
401

Error

  • erroroptionalobject
Example
{
  "error": {
    "message": "string",
    "code": "string"
  }
}
Code examples
cURL
curl -X GET "https://api.agenticdeveloperhub.com/gamification/leaderboard" \
  -H "Authorization: Bearer YOUR_TOKEN"
JavaScript
const res = await fetch("https://api.agenticdeveloperhub.com/gamification/leaderboard", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN"
  },
});
const data = await res.json();