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

# Get User Usage Stats

> Get detailed usage statistics for current user

Returns operation counts, token usage, and success rates by operation type



## OpenAPI

````yaml /openapi.json get /v1/users/me/usage
openapi: 3.1.0
info:
  title: Universal Document AI API
  description: AI-powered document editing with multi-tenant organization support
  version: 2.0.0
servers: []
security: []
paths:
  /v1/users/me/usage:
    get:
      tags:
        - users
      summary: Get User Usage Stats
      description: >-
        Get detailed usage statistics for current user


        Returns operation counts, token usage, and success rates by operation
        type
      operationId: get_user_usage_stats_v1_users_me_usage_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UsageStatsResponse'
      security:
        - HTTPBearer: []
components:
  schemas:
    UsageStatsResponse:
      properties:
        user_id:
          type: string
          title: User Id
          description: User identifier.
        subscription_tier:
          type: string
          title: Subscription Tier
          description: 'Current plan: ''free'', ''plus'', ''pro'', or ''enterprise''.'
        monthly_limit:
          type: integer
          title: Monthly Limit
          description: Maximum operations allowed per month. -1 means unlimited.
        monthly_used:
          type: integer
          title: Monthly Used
          description: Operations used this billing cycle.
        monthly_remaining:
          type: integer
          title: Monthly Remaining
          description: Operations remaining this cycle.
        monthly_reset_at:
          anyOf:
            - type: string
            - type: 'null'
          title: Monthly Reset At
          description: ISO 8601 timestamp when the monthly counter resets.
        total_sessions:
          type: integer
          title: Total Sessions
          description: Total number of chat sessions created.
        total_documents:
          type: integer
          title: Total Documents
          description: Total number of documents processed.
        total_operations:
          type: integer
          title: Total Operations
          description: Lifetime total operations across all billing cycles.
        current_month_stats:
          additionalProperties: true
          type: object
          title: Current Month Stats
          description: >-
            Breakdown of this month's operations by type, including counts,
            tokens used, and success rates.
      type: object
      required:
        - user_id
        - subscription_tier
        - monthly_limit
        - monthly_used
        - monthly_remaining
        - total_sessions
        - total_documents
        - total_operations
        - current_month_stats
      title: UsageStatsResponse
      description: Detailed usage statistics for the current billing cycle.
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer

````