# Retrieve User Details

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /v2/users:
    get:
      summary: Retrieve User Details
      deprecated: false
      description: >-
        Use this endpoint to fetch details of the authenticated user, including
        their active plan, mailbox usage, and wallet balance.
      tags:
        - users
      parameters:
        - name: x-auth-zapmail
          in: header
          description: ''
          required: true
          example: ''
          schema:
            type: string
        - name: x-workspace-key
          in: header
          description: ''
          required: false
          example: ''
          schema:
            type: string
        - name: ' x-service-provider'
          in: header
          description: ''
          required: false
          example: ''
          schema:
            type: string
            enum:
              - GOOGLE
              - MICROSOFT
            x-apidog-enum:
              - value: GOOGLE
                name: GOOGLE
                description: ''
              - value: MICROSOFT
                name: MICROSOFT
                description: ''
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: integer
                  message:
                    type: string
                  data:
                    type: object
                    properties:
                      id:
                        type: string
                      email:
                        type: string
                      firstName:
                        type: string
                      lastName:
                        type: string
                      activePlan:
                        type: string
                      planEndsOn:
                        type: string
                      purchasedMailboxes:
                        type: integer
                      assignedMailboxes:
                        type: integer
                      userCreatedAt:
                        type: string
                      walletBalance:
                        type: number
                        description: Balance amount in USD ($)
                    x-apidog-orders:
                      - id
                      - email
                      - firstName
                      - lastName
                      - activePlan
                      - planEndsOn
                      - purchasedMailboxes
                      - assignedMailboxes
                      - userCreatedAt
                      - walletBalance
                    required:
                      - id
                      - email
                      - firstName
                      - lastName
                      - activePlan
                      - planEndsOn
                      - purchasedMailboxes
                      - assignedMailboxes
                      - userCreatedAt
                      - walletBalance
                x-apidog-orders:
                  - status
                  - message
                  - data
                required:
                  - status
                  - message
                  - data
              example:
                status: 200
                message: User details fetched successfully
                data:
                  id: 12345678-abcd-4efg-90hi-1234567890jk
                  email: example@domain.com
                  firstName: John
                  lastName: Doe
                  activePlan: Premium
                  planEndsOn: '2025-03-10T15:00:00.000Z'
                  purchasedMailboxes: 120
                  assignedMailboxes: 85
                  userCreatedAt: '2023-01-15T08:30:00.000Z'
                  walletBalance: 100.5
          headers: {}
          x-apidog-name: Success
        '401':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: integer
                  message:
                    type: string
                  errorId:
                    type: string
                required:
                  - status
                  - message
                  - errorId
                x-apidog-orders:
                  - status
                  - message
                  - errorId
              example:
                status: 401
                message: Invalid API key
                errorId: dcf7cb0c-4d55-451e-88ba-73541d781ee4
          headers: {}
          x-apidog-name: Unauthorized
      security: []
      x-apidog-folder: users
      x-apidog-status: released
      x-run-in-apidog: https://app.apidog.com/web/project/797058/apis/api-13489341-run
components:
  schemas: {}
  securitySchemes: {}
servers:
  - url: https://api.zapmail.ai/api
    description: Prod Env
security: []

```