---
title: "Get User Usage Stats"
method: GET
path: "/v1/users/me/usage"
tags: ["users"]
---

# Get User Usage Stats

`GET /v1/users/me/usage`

## Request

- Base URL: `https://api.superdocs.app`
- URL: `https://api.superdocs.app/v1/users/me/usage`
- Auth: HTTP bearer

Get detailed usage statistics for current user

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

## Response `200`

Successful Response

- UsageStatsResponse: Detailed usage statistics for the current billing cycle.
  - `user_id` string, required: User identifier.
  - `subscription_tier` string, required: Current plan: 'free', 'plus', 'pro', or 'enterprise'.
  - `monthly_limit` integer, required: Maximum operations allowed per month. -1 means unlimited.
  - `monthly_used` integer, required: Operations used this billing cycle.
  - `monthly_remaining` integer, required: Operations remaining this cycle.
  - `monthly_reset_at` string, nullable: ISO 8601 timestamp when the monthly counter resets.
  - `total_sessions` integer, required: Total number of chat sessions created.
  - `total_documents` integer, required: Total number of documents processed.
  - `total_operations` integer, required: Lifetime total operations across all billing cycles.
  - `current_month_stats` object, required: Breakdown of this month's operations by type, including counts, tokens used, and success rates.

---

[API](https://skmtc.dev/superdocs/apis/universal-document-ai-api.md) · [All operations](https://skmtc.dev/superdocs/apis/universal-document-ai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/superdocs/apis/universal-document-ai-api/revisions/37d03122940b?raw)