> ## Documentation Index
> Fetch the complete documentation index at: https://docs.electronhub.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Routing Usage

> Requests per hour and model share. `scope=global` covers all users, needs no API key, and is cached for 60 seconds; models under 50 requests are grouped as `Other`.



## OpenAPI

````yaml GET /router/stats/usage
openapi: 3.0.1
info:
  title: Electron Hub API
  description: >-
    Unified API platform integrating 200+ AI models for chat, image generation,
    speech-to-text, embeddings, and more.
  version: 1.0.0
  contact:
    name: Electron Hub Support
    email: support@electronhub.ai
    url: https://discord.com/invite/electronhub
  license:
    name: MIT
servers:
  - url: https://api.electronhub.ai/v1
    description: Production API v1
security:
  - bearerAuth: []
paths:
  /router/stats/usage:
    get:
      tags:
        - Router
      summary: Routing usage
      description: >-
        Requests per hour and model share. `scope=global` covers all users,
        needs no API key, and is cached for 60 seconds; models under 50 requests
        are grouped as `Other`.
      operationId: getRouterUsageStats
      parameters:
        - name: scope
          in: query
          schema:
            type: string
            enum:
              - me
              - global
            default: me
        - name: window
          in: query
          schema:
            type: string
            enum:
              - 1h
              - 24h
              - 7d
            default: 24h
        - name: surface
          in: query
          schema:
            type: string
            enum:
              - agentic
              - non_agentic
              - all
            default: all
        - name: tier
          in: query
          schema:
            type: string
            enum:
              - all
              - low
              - medium
              - high
              - xhigh
              - max
            default: all
        - name: kind
          in: query
          schema:
            type: string
            enum:
              - new_work
              - all
            default: all
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
              example:
                total: 4
                buckets:
                  - t: '2026-11-08T07:00:00Z'
                    byModel:
                      deepseek-v4-flash: 2
                      muse-spark-1.3-contributor: 2
                share:
                  - model: deepseek-v4-flash
                    pct: 50
                  - model: muse-spark-1.3-contributor
                    pct: 50
                other_pct: 0
        '400':
          description: Invalid request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                error:
                  message: Body must be an object.
                  type: invalid_request_error
                  param: null
                  code: 400
      security:
        - {}
        - bearerAuth: []
components:
  schemas:
    Error:
      type: object
      required:
        - error
      properties:
        error:
          type: object
          required:
            - message
            - type
          properties:
            message:
              type: string
            type:
              type: string
            code:
              type: string
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: Enter your API key (starts with 'ek-')

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.