Get user by ID

Retrieve a user by their ID.

GET /users/{id}

Get user by ID

cURL

curl --request GET \
  --url https://{subdomain}.nudj.cx/api/v2/admin/users/{id} \
  --header 'x-api-token: <api-key>'

200

{
  "id": "<string>",
  "username": "<string>",
  "points": 123,
  "keys": 123,
  "xp": {
    "total": 1,
    "knowledge": 1,
    "creativity": 1,
    "loyalty": 1,
    "influence": 1,
    "participation": 1,
    "contribution": 1
  },
  "communityData": [
    {
      "communityId": "<string>",
      "streak": {
        "currentStreak": 1,
        "lastExtendedAt": "<string>",
        "longestStreak": 1
      },
      "challengesCompleted": 1,
      "achievementsCompleted": 1,
      "points": 123,
      "xp": {
        "total": 1,
        "knowledge": 1,
        "creativity": 1,
        "loyalty": 1,
        "influence": 1,
        "participation": 1,
        "contribution": 1
      },
      "hasAcceptedRules": true
    }
  ],
  "createdAt": "<string>",
  "roles": [
    "<string>"
  ],
  "email": "<string>",
  "isAnonymous": true,
  "updatedAt": "<string>",
  "organisationId": "<string>",
  "displayName": "<string>",
  "bio": "<string>",
  "profilePictureUrl": "<string>",
  "emailVerified": "<string>",
  "locale": "<string>",
  "socialHandles": {
    "instagram": "<string>",
    "loyaltyCardNumber": "<string>",
    "tiktok": "<string>"
  },
  "fullName": "John Doe",
  "parentEmail": "<string>",
  "birthDay": 123,
  "birthMonth": 123,
  "birthYear": 123,
  "externalUserId": "<string>"
}

Authorizations

x-api-token · string · header · required

Path Parameters

id · string · required

The ID of the user to get. This can be the internal ID or the external ID.

Response

200

application/json

Successful response

A user

id · string · required

username · string · required

points · number · required

keys · number · required

xp · User XP Breakdown · object · required

User XP Breakdown

Show child attributes

communityData · object[] · required

Show child attributes

createdAt · string · required

roles · string[] · required

email · string · required

isAnonymous · boolean · required

updatedAt · string · required

organisationId · string | null

displayName · string | null

bio · string | null

profilePictureUrl · string | null

emailVerified · string | null

locale · string | null

socialHandles · SocialHandles · object

Social media handles and loyalty information for a user

Show child attributes

fullName · string | null

Example:

"John Doe"

parentEmail · string | null

birthDay · number | null

birthMonth · number | null

birthYear · number | null

externalUserId · string | null