> ## Documentation Index
> Fetch the complete documentation index at: https://superwhisper-docs-cloud-model-rate-limits.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Get summary statistics

> Returns aggregated totals for recordings, duration, words, and processing times within a date range.



## OpenAPI

````yaml https://api.superwhisper.com/api/v1/openapi.json get /api/v1/stats/summary
openapi: 3.1.0
info:
  title: SuperWhisper API
  version: 1.0.0
  description: Public API for accessing SuperWhisper organization data.
servers:
  - url: https://api.superwhisper.com
    description: Production
security:
  - bearerAuth: []
paths:
  /api/v1/stats/summary:
    get:
      tags:
        - Stats
      summary: Get summary statistics
      description: >-
        Returns aggregated totals for recordings, duration, words, and
        processing times within a date range.
      parameters:
        - name: start_date
          in: query
          required: false
          description: ISO 8601 start date (defaults to 7 days ago)
          schema:
            type: string
            pattern: >-
              ^\d{4}-\d{2}-\d{2}(T\d{2}:\d{2}:\d{2}(\.\d+)?(Z|[+-]\d{2}:?\d{2})?)?$
        - name: end_date
          in: query
          required: false
          description: ISO 8601 end date (defaults to now)
          schema:
            type: string
            pattern: >-
              ^\d{4}-\d{2}-\d{2}(T\d{2}:\d{2}:\d{2}(\.\d+)?(Z|[+-]\d{2}:?\d{2})?)?$
        - name: filter[member_email]
          in: query
          required: false
          description: Comma-separated member email addresses
          schema:
            type: string
        - name: filter[voice_model]
          in: query
          required: false
          description: Comma-separated voice models
          schema:
            type: string
        - name: filter[language_model]
          in: query
          required: false
          description: Comma-separated language models
          schema:
            type: string
        - name: filter[app_name]
          in: query
          required: false
          description: Comma-separated app names
          schema:
            type: string
      responses:
        '200':
          description: Summary statistics
          content:
            application/json:
              schema:
                type: object
                properties:
                  total_recordings:
                    type: number
                    description: Total number of recordings
                  total_duration_minutes:
                    type: number
                    description: Total recording duration in minutes
                  total_words:
                    type: number
                    description: Total words transcribed
                  avg_llm_processing_seconds:
                    type: number
                    description: Average LLM processing time in seconds
                  avg_voice_processing_seconds:
                    type: number
                    description: Average voice processing time in seconds
                required:
                  - total_recordings
                  - total_duration_minutes
                  - total_words
                  - avg_llm_processing_seconds
                  - avg_voice_processing_seconds
                $schema: http://json-schema.org/draft-07/schema#
        '401':
          description: Unauthorized — missing or invalid bearer token
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: API access token (starts with sk-sw-)

````