# Usage Statistics

Retrieve detailed usage statistics and reset times.

`GET /api/usage`

### Example Request

```bash
curl -X GET "https://developer.nabzclan.vip/api/usage" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Accept: application/json"
```

### Response Body

```json
{
  "plan": "VIP 4",
  "daily_limit": 500,
  "ai_limit": 500,
  "ai_period": "day",
  "used_today": 10,
  "remaining": 490,
  "reset_at": "2026-01-04T23:59:59.999999Z"
}
```

> **Note:** A value of `-1` for any limit or remaining count indicates "Unlimited".

### Response Fields

| Field | Description |
|-------|-------------|
| `ai_period` | The time window for AI usage limits. Can be `day` (resets daily) or `week` (resets weekly). |