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

# Get Usage

> Get usage statistics for the current billing period

## Response

<ResponseField name="characters_used" type="integer" required>
  Characters used this period
</ResponseField>

<ResponseField name="characters_limit" type="integer" required>
  Character quota for current tier
</ResponseField>

<ResponseField name="requests_today" type="integer" required>
  API requests made today
</ResponseField>

<ResponseField name="period_start" type="string" required>
  Start of current billing period
</ResponseField>

<ResponseField name="period_end" type="string" required>
  End of current billing period
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl "https://api.destined.ai/v1/users/usage" \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```

  ```typescript TypeScript theme={null}
  const usage = await client.users.getUsageV1UsersUsageGet();

  const percentUsed = (usage.charactersUsed / usage.charactersLimit) * 100;
  console.log(`${percentUsed.toFixed(1)}% of quota used`);
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "characters_used": 45000,
    "characters_limit": 100000,
    "requests_today": 150,
    "period_start": "2024-01-01",
    "period_end": "2024-01-31",
    "subscription_tier": "pro"
  }
  ```
</ResponseExample>