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

# Get Usage Stats

`GET /subscriptions/usage`

Get current period usage statistics.

## Headers

- `authorization` string, nullable

## Response `200`

Successful Response

- UsageStatsResponse — Response for usage statistics (2-tier daily limits)
  - `tier` string, required
  - `chacha_messages` UsageBreakdown, required — Usage breakdown with percentage, used, and limit. `window` says what period `used` and `limit` are measured over. It defaults to "day" because every consumer tier is rationed daily; a school seat is rationed by the WEEK, and a screen that prints a weekly figure under the word "today" is simply wrong. `resets_on` is the last date of that window. `resets_at` is the exact INSTANT it next rolls over, in UTC, so the client can print it on the reader's own clock. The daily counters turn over at midnight New York and a school week turns over at midnight in the school's zone — neither is the reader's midnight, so "resets at midnight" was telling a learner in Berlin something untrue by six hours.
    - `percentage_used` number, required
    - `used` number, required
    - `limit` number, required
    - `window` string
    - `resets_on` string, nullable
    - `resets_at` string, nullable
  - `daily_transcription` UsageBreakdown, required — Usage breakdown with percentage, used, and limit. `window` says what period `used` and `limit` are measured over. It defaults to "day" because every consumer tier is rationed daily; a school seat is rationed by the WEEK, and a screen that prints a weekly figure under the word "today" is simply wrong. `resets_on` is the last date of that window. `resets_at` is the exact INSTANT it next rolls over, in UTC, so the client can print it on the reader's own clock. The daily counters turn over at midnight New York and a school week turns over at midnight in the school's zone — neither is the reader's midnight, so "resets at midnight" was telling a learner in Berlin something untrue by six hours.
    - `percentage_used` number, required
    - `used` number, required
    - `limit` number, required
    - `window` string
    - `resets_on` string, nullable
    - `resets_at` string, nullable
  - `daily_voice` UsageBreakdown — Usage breakdown with percentage, used, and limit. `window` says what period `used` and `limit` are measured over. It defaults to "day" because every consumer tier is rationed daily; a school seat is rationed by the WEEK, and a screen that prints a weekly figure under the word "today" is simply wrong. `resets_on` is the last date of that window. `resets_at` is the exact INSTANT it next rolls over, in UTC, so the client can print it on the reader's own clock. The daily counters turn over at midnight New York and a school week turns over at midnight in the school's zone — neither is the reader's midnight, so "resets at midnight" was telling a learner in Berlin something untrue by six hours.
    - `percentage_used` number, required
    - `used` number, required
    - `limit` number, required
    - `window` string
    - `resets_on` string, nullable
    - `resets_at` string, nullable
  - `call_minutes_per_call` number, required
  - `ai_usage` UsageBreakdown, required — Usage breakdown with percentage, used, and limit. `window` says what period `used` and `limit` are measured over. It defaults to "day" because every consumer tier is rationed daily; a school seat is rationed by the WEEK, and a screen that prints a weekly figure under the word "today" is simply wrong. `resets_on` is the last date of that window. `resets_at` is the exact INSTANT it next rolls over, in UTC, so the client can print it on the reader's own clock. The daily counters turn over at midnight New York and a school week turns over at midnight in the school's zone — neither is the reader's midnight, so "resets at midnight" was telling a learner in Berlin something untrue by six hours.
    - `percentage_used` number, required
    - `used` number, required
    - `limit` number, required
    - `window` string
    - `resets_on` string, nullable
    - `resets_at` string, nullable
  - `live_transcriptions` UsageBreakdown, required — Usage breakdown with percentage, used, and limit. `window` says what period `used` and `limit` are measured over. It defaults to "day" because every consumer tier is rationed daily; a school seat is rationed by the WEEK, and a screen that prints a weekly figure under the word "today" is simply wrong. `resets_on` is the last date of that window. `resets_at` is the exact INSTANT it next rolls over, in UTC, so the client can print it on the reader's own clock. The daily counters turn over at midnight New York and a school week turns over at midnight in the school's zone — neither is the reader's midnight, so "resets at midnight" was telling a learner in Berlin something untrue by six hours.
    - `percentage_used` number, required
    - `used` number, required
    - `limit` number, required
    - `window` string
    - `resets_on` string, nullable
    - `resets_at` string, nullable
  - `call_minutes` UsageBreakdown, required — Usage breakdown with percentage, used, and limit. `window` says what period `used` and `limit` are measured over. It defaults to "day" because every consumer tier is rationed daily; a school seat is rationed by the WEEK, and a screen that prints a weekly figure under the word "today" is simply wrong. `resets_on` is the last date of that window. `resets_at` is the exact INSTANT it next rolls over, in UTC, so the client can print it on the reader's own clock. The daily counters turn over at midnight New York and a school week turns over at midnight in the school's zone — neither is the reader's midnight, so "resets at midnight" was telling a learner in Berlin something untrue by six hours.
    - `percentage_used` number, required
    - `used` number, required
    - `limit` number, required
    - `window` string
    - `resets_on` string, nullable
    - `resets_at` string, nullable
  - `detailed_reports` UsageBreakdown — Usage breakdown with percentage, used, and limit. `window` says what period `used` and `limit` are measured over. It defaults to "day" because every consumer tier is rationed daily; a school seat is rationed by the WEEK, and a screen that prints a weekly figure under the word "today" is simply wrong. `resets_on` is the last date of that window. `resets_at` is the exact INSTANT it next rolls over, in UTC, so the client can print it on the reader's own clock. The daily counters turn over at midnight New York and a school week turns over at midnight in the school's zone — neither is the reader's midnight, so "resets at midnight" was telling a learner in Berlin something untrue by six hours.
    - `percentage_used` number, required
    - `used` number, required
    - `limit` number, required
    - `window` string
    - `resets_on` string, nullable
    - `resets_at` string, nullable
  - `is_trial_active` boolean, required
  - `trial_end_date` string, date-time, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/fluentea/apis/aurqa-language-learning-platform-refactored.md) · [All operations](https://skmtc.dev/fluentea/apis/aurqa-language-learning-platform-refactored/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/fluentea/aurqa-language-learning-platform-refactored/revisions/78f314acd8bf/schema)