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

# Get Usage Stats

`GET /me/usage`

## Request

- Base URL: `https://api.oxlo.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.oxlo.ai/me/usage`
- Auth: HTTP bearer

Get aggregated usage statistics for the current user.
Includes chat tokens, model usage, images, content seconds, and cost savings.

simulate_plan: Admin-only param to preview how the page looks for a different tier.

## Query parameters

- `period` string
- `simulate_plan` string, nullable

## Response `200`

Successful Response

- UsageStatsResponse
  - `requests_today` integer, required
  - `total_tokens` integer, required
  - `prompt_tokens` integer, required
  - `completion_tokens` integer, required
  - `success_rate` number, required
  - `requests_by_hour` HourlyData[], required
    - `hour` integer, required
    - `count` integer, required
  - `breakdown_by_key` KeyBreakdown[], required
    - `api_key_id` string, required
    - `label` string, nullable, required
    - `requests` integer, required
    - `tokens` integer, required
  - `requests_per_day_limit` integer, nullable
  - `requests_per_hour_limit` integer, nullable
  - `plan_name` string, nullable
  - `chat_tokens` integer
  - `chat_prompt_tokens` integer
  - `chat_completion_tokens` integer
  - `unique_models_used` integer
  - `available_models_count` integer
  - `content_seconds` number
  - `content_seconds_breakdown` ContentSecondsBreakdown
    - `audio_seconds` number
    - `detect_seconds` number
    - `total_seconds` number
  - `content_by_model` ContentModelItem[]
    - `display_name` string, required
    - `category` string, required
    - `seconds` number, required
  - `images_created` integer
  - `image_breakdown` ImageBreakdownItem[]
    - `model_name` string, required
    - `count` integer, required
  - `cost_savings` CostSavings
    - `benchmark_cost` number, required
    - `oxlo_cost` number, required
    - `savings` number, required
    - `savings_percent` number, required
    - `is_positive` boolean, required
  - `savings_by_model` SavingsModelItem[]
    - `display_name` string, required
    - `category` string, required
    - `benchmark_cost` number, required
  - `breakdown_by_model` ModelBreakdown[]
    - `model_name` string, required
    - `display_name` string, required
    - `category` string, required
    - `requests` integer, required
    - `tokens` integer, required
    - `prompt_tokens` integer, required
    - `completion_tokens` integer, required
  - `fallback_requests_today` integer, nullable
  - `fallback_requests_limit` integer, nullable
  - `enterprise_requests_today` integer, nullable
  - `allowed_models` string[], nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/oxlo/apis/oxlo-backend.md) - [All operations](https://skmtc.dev/oxlo/apis/oxlo-backend/llms.txt) - [OpenAPI document](https://skmtc.dev/oxlo/apis/oxlo-backend/revisions/bc2ecdc94f31?raw)