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

# Get Usage Stats

> Get usage statistics and quota information

## Response

<ResponseField name="period" type="object">
  Current billing period with `start` and `end` dates.
</ResponseField>

<ResponseField name="usage" type="object">
  Usage counts for the current period.
</ResponseField>

<ResponseField name="quotas" type="object">
  Your plan limits.
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://prod.api.unleeshed.ai/partner/v1/usage" \
    -H "X-Api-Key: pk_live_your_api_key"
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch('https://prod.api.unleeshed.ai/partner/v1/usage', {
    headers: { 'X-Api-Key': 'pk_live_your_api_key' }
  });
  ```

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

  response = requests.get(
      "https://prod.api.unleeshed.ai/partner/v1/usage",
      headers={"X-Api-Key": "pk_live_your_api_key"}
  )
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "success": true,
    "data": {
      "period": {
        "start": "2026-01-01T00:00:00Z",
        "end": "2026-01-31T23:59:59Z"
      },
      "usage": {
        "topics_created": 127,
        "commentaries_generated": 312,
        "api_calls": 1847
      },
      "quotas": {
        "topics_per_month": 1000,
        "commentaries_per_month": 5000,
        "api_calls_per_hour": 1000
      },
      "remaining": {
        "topics": 873,
        "commentaries": 4688
      }
    }
  }
  ```
</ResponseExample>