---
title: "Get paginated statistics"
method: GET
path: "/api/v1/stats"
tags: ["Stats"]
---

# Get paginated statistics

`GET /api/v1/stats`

Returns time-series usage statistics with optional grouping, filtering, and pagination. Supports JSON and CSV output formats.

## Query parameters

- `start_date` string
- `end_date` string
- `granularity` 'hour' | 'day' | 'week' | 'month'
- `group_by` 'member_email' | 'voice_model' | 'language_model' | 'app_name'
- `page` integer
- `page_size` integer
- `format` 'json' | 'csv'
- `filter[member_email]` string
- `filter[voice_model]` string
- `filter[language_model]` string
- `filter[app_name]` string

## Response `200`

Paginated statistics (or CSV file when format=csv)

- object
  - `data` object[], required
    - `time_bucket` string, required — Start of the time period (ISO 8601)
    - `recording_count` number, required — Number of recordings in this period
    - `total_words` number, required — Total words transcribed
    - `total_duration` number, required — Total duration in milliseconds
    - `avg_llm_processing_time` number, required — Average LLM processing time in milliseconds
    - `avg_voice_processing_time` number, required — Average voice processing time in milliseconds
    - `avg_wpm` number, required — Average words per minute
  - `pagination` object, required
    - `page` number, required — Current page number
    - `page_size` number, required — Number of results per page
    - `total_rows` number, required — Total number of results
    - `total_pages` number, required — Total number of pages
    - `count` number, required — Number of results returned in this page
  - `meta` object, required
    - `start_date` string, required — Query start date
    - `end_date` string, required — Query end date
    - `granularity` string, required — Time bucket granularity used
    - `group_by` string, nullable, required — Grouping dimension used, if any

## Other responses

- `400` — Invalid parameters
- `401` — Unauthorized — missing or invalid bearer token

---

[API](https://skmtc.dev/superwhisper/apis/superwhisper-api.md) · [All operations](https://skmtc.dev/superwhisper/apis/superwhisper-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/superwhisper/superwhisper-api/revisions/a41778841330/schema)