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

# Get User Details

> Retrieves detailed information about a specific user including engagement statistics.



## OpenAPI

````yaml api-reference/openapiFiles/users/GetUser/openapi.json get /users/{_id}
openapi: 3.0.1
info:
  title: YJSG Institution APIs
  description: >-
    APIs for educational institutions to manage student accounts and track
    engagement.
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.yourjobsearchgenius.ai/v1
    description: Production server
security:
  - bearerAuth: []
paths:
  /users/{_id}:
    get:
      description: >-
        Retrieves detailed information about a specific user including
        engagement statistics.
      parameters:
        - name: _id
          in: path
          description: The user's unique identifier
          required: true
          schema:
            type: string
            pattern: ^[a-fA-F0-9]{24}$
            example: 507f1f77bcf86cd799439011
      responses:
        '200':
          description: User details response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UserDetailResponse'
        '400':
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Invalid Token
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Resource not found!
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '422':
          description: Invalid data
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: Internal Server Error!
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    UserDetailResponse:
      type: object
      properties:
        data:
          $ref: '#/components/schemas/UserDetail'
        success:
          description: Indicates if the request was successful
          type: boolean
      required:
        - data
        - success
    Error:
      required:
        - error
      type: object
      properties:
        error:
          type: string
          format: s
    UserDetail:
      type: object
      properties:
        _id:
          description: ID of the user (MongoDB ObjectId)
          type: string
        firstName:
          description: The first name of the user.
          type: string
        lastName:
          description: The last name of the user.
          type: string
        email:
          description: Email address of the user.
          type: string
        uniqueUserId:
          description: Unique user ID assigned by the institution
          type: string
        accountStatus:
          description: Current status of the user account
          type: string
          enum:
            - active
            - inactive
        onboardingCompleted:
          description: Whether the user has completed onboarding
          type: boolean
        lastLoginDate:
          description: Date and time of the user's last login
          type: string
          format: date-time
        createdAt:
          description: Date and time when the user account was created
          type: string
          format: date-time
        autoLogin:
          $ref: '#/components/schemas/AutoLogin'
        engagementStats:
          $ref: '#/components/schemas/EngagementStats'
    AutoLogin:
      type: object
      properties:
        autoLoginUrl:
          description: The auto login URL for the user.
          type: string
          format: uri
        autoLoginCode:
          description: The auto login code for the user.
          type: string
    EngagementStats:
      type: object
      properties:
        resumesCount:
          description: Total number of resumes
          type: integer
        interviewsCount:
          description: Total number of interviews
          type: integer
        jobTracking:
          $ref: '#/components/schemas/JobTracking'
        mockInterviews:
          $ref: '#/components/schemas/MockInterviews'
        offerNegotiationsCount:
          description: Total number of offer negotiations
          type: integer
        contactsCount:
          description: Total number of contacts
          type: integer
        coverLettersCount:
          description: Total number of cover letters
          type: integer
    JobTracking:
      type: object
      properties:
        totalJobs:
          description: Total number of tracked jobs
          type: integer
        statusBreakdown:
          $ref: '#/components/schemas/JobTrackingStatusBreakdown'
    MockInterviews:
      type: object
      properties:
        totalInterviews:
          description: Total number of mock interviews
          type: integer
        interviews:
          description: Array of mock interview objects
          type: array
          items:
            $ref: '#/components/schemas/MockInterview'
    JobTrackingStatusBreakdown:
      type: object
      properties:
        applied:
          description: Number of jobs applied to
          type: integer
        interviewing:
          description: Number of jobs in interviewing stage
          type: integer
        offered:
          description: Number of job offers received
          type: integer
        rejected:
          description: Number of job rejections
          type: integer
    MockInterview:
      type: object
      properties:
        _id:
          description: ID of the mock interview
          type: string
        title:
          description: Title of the interview
          type: string
        stageType:
          description: Type of interview stage
          type: string
        difficulty:
          description: Difficulty level of the interview
          type: string
        isCompleted:
          description: Whether the interview is completed
          type: boolean
        createdAt:
          description: Date when the interview was created
          type: string
          format: date-time
        takeCount:
          description: Number of times this interview was taken
          type: integer
        averageScore:
          description: Average score across all takes
          type: number
        allTakes:
          description: Array of all interview takes
          type: array
          items:
            $ref: '#/components/schemas/MockInterviewTake'
    MockInterviewTake:
      type: object
      properties:
        _id:
          description: ID of the interview take
          type: string
        title:
          description: Title of the interview
          type: string
        stageType:
          description: Type of interview stage
          type: string
        difficulty:
          description: Difficulty level of the interview
          type: string
        isCompleted:
          description: Whether the interview is completed
          type: boolean
        createdAt:
          description: Date when the interview was created
          type: string
          format: date-time
        score:
          description: Score achieved in this take
          type: number
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````