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

# API Usage Stats

> Get API usage statistics and daily limits

Get your current API usage statistics including daily limits and current usage for rate-limited endpoints.

## Headers

<ParamField header="Authorization" type="string" required>
  Bearer token: `Bearer <access_token>`
</ParamField>

## Response

<ResponseField name="user_id" type="string">
  Your user ID
</ResponseField>

<ResponseField name="email" type="string">
  Your email address
</ResponseField>

<ResponseField name="usage" type="object">
  Current usage statistics including requests made today
</ResponseField>

<ResponseField name="limits" type="object">
  <Expandable title="properties">
    <ResponseField name="detail_endpoints_daily" type="number">
      Maximum detail endpoint requests per day (default: 100)
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET https://api.finscreener.in/api/usage/stats \
    -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      "https://api.finscreener.in/api/usage/stats",
      headers={"Authorization": f"Bearer {token}"}
  )
  stats = response.json()
  print(f"Detail requests today: {stats['usage']}")
  print(f"Daily limit: {stats['limits']['detail_endpoints_daily']}")
  ```
</RequestExample>

<ResponseExample>
  ```json Success theme={null}
  {
    "user_id": "user_123456",
    "email": "user@example.com",
    "usage": {
      "detail_requests_today": 15,
      "detail_requests_date": "2026-03-20"
    },
    "limits": {
      "detail_endpoints_daily": 100
    }
  }
  ```
</ResponseExample>