> ## 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.

# Get Usage

> Get current user usage statistics and account information

Retrieve current user usage statistics, account information, and billing details.

## Response

Returns comprehensive usage information including subscription status, remaining credits, token usage, request history, and endpoint-specific usage statistics.

## Example Response

```json theme={null}
{
  "subscription": "pro",
  "credits": 1250,
  "usage": {
    "input_tokens": 45230,
    "output_tokens": 12870
  },
  "history": [
    {
      "date": "2024-12-26",
      "requests": 142
    },
    {
      "date": "2024-12-25",
      "requests": 98
    }
  ],
  "endpoints": {
    "chat.completions": 95,
    "images.generations": 23,
    "images.edits": 5,
    "videos.generations": 2
  }
}
```

## Code Examples

<CodeGroup>
  ```python Python theme={null}
  from httpx import Client

  api_key = "ek-your-api-key"
  headers = {
      "Authorization": f"Bearer {api_key}"
  }

  client = Client()
  response = client.get("https://api.electronhub.ai/v1/user/me", headers=headers)
  print(response.json())
  ```

  ```javascript Node.js theme={null}
  const response = await fetch('https://api.electronhub.ai/v1/user/me', {
    method: 'GET',
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY'
    }
  });

  const data = await response.json();
  console.log(data);
  ```

  ```bash cURL theme={null}
  curl -X GET "https://api.electronhub.ai/v1/user/me" \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```
</CodeGroup>

## Response Fields

### subscription

Your current subscription plan (e.g., "free", "starter", "pro", "enterprise")

### credits

Number of credits remaining in your account

### usage

Token usage statistics:

* `input_tokens` - Total input tokens consumed
* `output_tokens` - Total output tokens generated

### history

Array of daily usage records showing request counts by date

### endpoints

Usage breakdown by API endpoint:

* `chat.completions` - Chat completion requests
* `images.generations` - Image generation requests
* `images.edits` - Image editing requests
* `videos.generations` - Video generation requests

## Use Cases

* **Monitor Usage**: Track API consumption to manage costs
* **Billing Information**: Check remaining credits and subscription status
* **Usage Analytics**: Analyze patterns in API usage over time
* **Endpoint Analysis**: Understand which endpoints are used most frequently

## Rate Limits

This endpoint is subject to standard rate limits. You can check usage information up to once per minute without impacting your request quota.


## OpenAPI

````yaml GET /user/me
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:
  /user/me:
    get:
      tags:
        - User
      summary: Get Usage
      description: Get current user usage statistics and account information
      operationId: getUsage
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UsageResponse'
components:
  schemas:
    UsageResponse:
      type: object
      required:
        - subscription
        - credits
        - usage
        - history
        - endpoints
      properties:
        subscription:
          type: string
          description: Current subscription plan
        credits:
          type: integer
          description: Remaining credits
        usage:
          type: object
          required:
            - input_tokens
            - output_tokens
          properties:
            input_tokens:
              type: integer
              description: Total input tokens used
            output_tokens:
              type: integer
              description: Total output tokens used
        history:
          type: array
          description: Daily usage history
          items:
            type: object
            required:
              - date
              - requests
            properties:
              date:
                type: string
                format: date
                description: Date in YYYY-MM-DD format
              requests:
                type: integer
                description: Number of requests made on this date
        endpoints:
          type: object
          description: Usage count by endpoint
          properties:
            chat.completions:
              type: integer
              description: Chat completion requests
            images.generations:
              type: integer
              description: Image generation requests
            images.edits:
              type: integer
              description: Image edit requests
            videos.generations:
              type: integer
              description: Video generation requests
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: Enter your API key (starts with 'ek-')

````