Skip to main content
GET
/
community
/
users
/
list
Community users list with summary stats
curl --request GET \
  --url https://{subdomain}.nudj.cx/api/v2/analytics/community/users/list
{
  "summary": {
    "totalUsers": 123,
    "activeUsers": 123,
    "averagePoints": 123,
    "mostRecentUserDate": "<string>"
  },
  "data": {
    "data": [
      {
        "_id": "<string>",
        "username": "<string>",
        "email": "<string>",
        "firstName": "<string>",
        "lastName": "<string>",
        "displayName": "<string>",
        "bio": "<string>",
        "phoneNumber": "<string>",
        "createdAt": "<string>",
        "updatedAt": "<string>",
        "lastLoginAt": "<string>",
        "emailVerified": "<string>",
        "roles": [
          "<string>"
        ],
        "role": "<string>",
        "profilePicture": "<string>",
        "profilePictureUrl": "<string>",
        "stats": {
          "totalPoints": 123,
          "totalXP": 123,
          "lastActivity": "<string>",
          "totalAchievements": 123,
          "totalChallengesCompleted": 123,
          "totalRewardsEarned": 123,
          "streakInfo": {
            "currentStreak": 123,
            "longestStreak": 123
          }
        }
      }
    ],
    "pagination": {
      "total": 123,
      "skip": 123,
      "limit": 123
    }
  }
}

Query Parameters

communityId
string
skip
integer
default:0
Required range: x >= 0
limit
integer
default:10
Required range: 1 <= x <= 100
sortField
enum<string>
default:lastActivity

Field to sort by. Supports base fields (createdAt, username, email, lastLoginAt, status, role, lastActivity) and computed stats (totalPoints, totalXP, totalAchievements, totalChallengesCompleted, totalRewards, currentStreak, longestStreak).

Available options:
createdAt,
username,
email,
lastLoginAt,
status,
role,
lastActivity,
totalPoints,
totalXP,
totalAchievements,
totalChallengesCompleted,
totalRewards,
currentStreak,
longestStreak
sortDirection
enum<string>
default:desc
Available options:
asc,
desc

Response

Successful response

summary
object
required
data
object
required
I