> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nudj.cx/llms.txt
> Use this file to discover all available pages before exploring further.

# Get comprehensive user details

> Retrieves comprehensive user details including stats, achievements, challenges, rewards, XP breakdown, and activity history.



## OpenAPI

````yaml /openapi/analytics.json get /users/details
openapi: 3.1.0
info:
  title: Nudj Analytics API
  version: 1.0.0
servers:
  - url: https://{subdomain}.nudj.cx/api/v2/analytics
    description: Organization API Server
    variables:
      subdomain:
        description: Your organization's subdomain (required)
        default: your-org
security: []
paths:
  /users/details:
    get:
      tags:
        - Users
      summary: Get comprehensive user details
      description: >-
        Retrieves comprehensive user details including stats, achievements,
        challenges, rewards, XP breakdown, and activity history.
      operationId: getUserDetails
      parameters:
        - in: query
          name: userId
          schema:
            type: string
          required: true
        - in: query
          name: communityId
          schema:
            type: string
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  userId:
                    type: string
                  username:
                    type: string
                  email:
                    type: string
                  displayName:
                    type:
                      - string
                      - 'null'
                  profilePictureUrl:
                    type:
                      - string
                      - 'null'
                  createdAt:
                    type: string
                  stats:
                    type: object
                    properties:
                      totalPoints:
                        type: number
                      totalXP:
                        type: number
                      currentLevel:
                        type: number
                      totalAchievements:
                        type: number
                      totalChallengesCompleted:
                        type: number
                      totalChallengesStarted:
                        type: number
                      totalRewardsEarned:
                        type: number
                    required:
                      - totalPoints
                      - totalXP
                      - currentLevel
                      - totalAchievements
                      - totalChallengesCompleted
                      - totalChallengesStarted
                      - totalRewardsEarned
                  xpBreakdown:
                    type: object
                    properties:
                      knowledge:
                        type: number
                      creativity:
                        type: number
                      participation:
                        type: number
                      loyalty:
                        type: number
                      influence:
                        type: number
                      contribution:
                        type: number
                      total:
                        type: number
                    required:
                      - knowledge
                      - creativity
                      - participation
                      - loyalty
                      - influence
                      - contribution
                      - total
                  achievements:
                    type: array
                    items:
                      type: object
                      properties:
                        achievementId:
                          type: string
                        achievementName:
                          type: string
                        progress:
                          type: number
                        progressMax:
                          type: number
                        isCompleted:
                          type: boolean
                        achievementDescription:
                          type: string
                        completedAt:
                          type:
                            - string
                            - 'null'
                        lastUpdatedAt:
                          type:
                            - string
                            - 'null'
                        expiresAt:
                          type:
                            - string
                            - 'null'
                        bannerUrl:
                          type:
                            - string
                            - 'null'
                        rewardId:
                          type:
                            - string
                            - 'null'
                        rewardName:
                          type:
                            - string
                            - 'null'
                        progressSummary: {}
                      required:
                        - achievementId
                        - achievementName
                        - progress
                        - progressMax
                        - isCompleted
                  challenges:
                    type: array
                    items:
                      type: object
                      properties:
                        challengeId:
                          type: string
                        challengeName:
                          type: string
                        status:
                          type: string
                        startedAt:
                          type:
                            - string
                            - 'null'
                        completedAt:
                          type:
                            - string
                            - 'null'
                        lastAttemptAt:
                          type:
                            - string
                            - 'null'
                        pointsEarned:
                          type: number
                        xpEarned:
                          type: number
                        attemptsCount:
                          type: number
                          default: 0
                        actionsCompleted:
                          type: number
                          default: 0
                        successRate:
                          type: number
                          default: 0
                        bannerUrl:
                          type:
                            - string
                            - 'null'
                      required:
                        - challengeId
                        - status
                        - pointsEarned
                        - xpEarned
                        - attemptsCount
                        - actionsCompleted
                        - successRate
                  rewardAssets:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        rewardId:
                          type: string
                        rewardName:
                          type: string
                        description:
                          type:
                            - string
                            - 'null'
                        bannerUrl:
                          type:
                            - string
                            - 'null'
                        type:
                          type: string
                          const: asset
                        acquiredAt:
                          type:
                            - string
                            - 'null'
                        claimedAt:
                          type:
                            - string
                            - 'null'
                        redeemedAt:
                          type:
                            - string
                            - 'null'
                        expiresAt:
                          type:
                            - string
                            - 'null'
                        expired:
                          type: boolean
                        status:
                          type: string
                          enum:
                            - issued
                            - claimed
                            - redeemed
                            - expired
                        redeemableType:
                          type:
                            - string
                            - 'null'
                        code:
                          type:
                            - string
                            - 'null'
                        allocationId:
                          type:
                            - string
                            - 'null'
                        eventCategory:
                          type:
                            - string
                            - 'null'
                        eventSubCategory:
                          type:
                            - string
                            - 'null'
                        eventSourceId:
                          type:
                            - string
                            - 'null'
                        communityId:
                          type:
                            - string
                            - 'null'
                      required:
                        - rewardId
                        - rewardName
                        - type
                  rewardEntries:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        rewardId:
                          type: string
                        rewardName:
                          type: string
                        description:
                          type:
                            - string
                            - 'null'
                        type:
                          type: string
                          const: entry
                        entryCount:
                          type: number
                        acquiredAt:
                          type:
                            - string
                            - 'null'
                        claimedAt:
                          type:
                            - string
                            - 'null'
                        redeemedAt:
                          type:
                            - string
                            - 'null'
                        expiresAt:
                          type:
                            - string
                            - 'null'
                        expired:
                          type: boolean
                        status:
                          type: string
                          enum:
                            - issued
                            - claimed
                            - redeemed
                            - expired
                        redeemableType:
                          type:
                            - string
                            - 'null'
                        code:
                          type:
                            - string
                            - 'null'
                        allocationId:
                          type:
                            - string
                            - 'null'
                        eventCategory:
                          type:
                            - string
                            - 'null'
                        eventSubCategory:
                          type:
                            - string
                            - 'null'
                        eventSourceId:
                          type:
                            - string
                            - 'null'
                        communityId:
                          type:
                            - string
                            - 'null'
                        bannerUrl:
                          type:
                            - string
                            - 'null'
                      required:
                        - rewardId
                        - rewardName
                        - type
                  streaks:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        achievementId:
                          type: string
                        achievementName:
                          type: string
                        communityId:
                          type: string
                        communityName:
                          type: string
                        currentStreak:
                          type: number
                        longestStreak:
                          type: number
                        lastExtendedAt:
                          type: string
                        streakPeriods:
                          type: array
                          items: {}
                      required:
                        - id
                        - achievementId
                        - achievementName
                        - communityId
                        - communityName
                        - currentStreak
                        - longestStreak
                        - lastExtendedAt
                        - streakPeriods
                required:
                  - userId
                  - username
                  - email
                  - createdAt
                  - stats
                  - xpBreakdown
                  - achievements
                  - challenges
                  - rewardAssets
                  - rewardEntries
                  - streaks
        '400':
          description: Invalid input data
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/error.BAD_REQUEST'
        '404':
          description: Not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/error.NOT_FOUND'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/error.INTERNAL_SERVER_ERROR'
components:
  schemas:
    error.BAD_REQUEST:
      type: object
      properties:
        message:
          type: string
          description: The error message
          example: Invalid input data
        code:
          type: string
          description: The error code
          example: BAD_REQUEST
        issues:
          type: array
          items:
            type: object
            properties:
              message:
                type: string
            required:
              - message
          description: An array of issues that were responsible for the error
          example: []
      required:
        - message
        - code
      title: Error
      description: The error information
      example:
        code: BAD_REQUEST
        message: Invalid input data
        issues: []
    error.NOT_FOUND:
      type: object
      properties:
        message:
          type: string
          description: The error message
          example: Not found
        code:
          type: string
          description: The error code
          example: NOT_FOUND
        issues:
          type: array
          items:
            type: object
            properties:
              message:
                type: string
            required:
              - message
          description: An array of issues that were responsible for the error
          example: []
      required:
        - message
        - code
      title: Error
      description: The error information
      example:
        code: NOT_FOUND
        message: Not found
        issues: []
    error.INTERNAL_SERVER_ERROR:
      type: object
      properties:
        message:
          type: string
          description: The error message
          example: Internal server error
        code:
          type: string
          description: The error code
          example: INTERNAL_SERVER_ERROR
        issues:
          type: array
          items:
            type: object
            properties:
              message:
                type: string
            required:
              - message
          description: An array of issues that were responsible for the error
          example: []
      required:
        - message
        - code
      title: Error
      description: The error information
      example:
        code: INTERNAL_SERVER_ERROR
        message: Internal server error
        issues: []

````