# My Quota

sidebar:
  order: 30

## GET /api/quantis/v2/me/quota/

Returns your current API quota status for the billing period. This endpoint is **free** — calling it does not count against your monthly quota.

| | |
|---|---|
| **Method** | `GET` |
| **URL** | `https://app.vzla.io/api/quantis/v2/me/quota/` |
| **Authentication** | `Authorization: Bearer vzlaio_...` |
| **Parameters** | None |

### Request

```bash
curl --request GET \
  --url 'https://app.vzla.io/api/quantis/v2/me/quota/' \
  --header 'Authorization: Bearer vzlaio_YOUR_TOKEN_HERE'
```

---
sidebar:
  order: 30

### Response

The quota response is a **flat object** — there is no `data`/`meta` envelope.

| Field | Type | Description |
|---|---|---|
| `subscription` | string | Your current plan name, e.g. `"Free"` |
| `monthly_limit` | integer | Your plan's monthly request limit |
| `current_usage` | integer | Requests made this calendar month |
| `remaining` | integer | Requests remaining before quota is exhausted |
| `usage_percentage` | number | `current_usage / monthly_limit × 100` |
| `status_level` | string | `"normal"`, `"warning"`, or `"critical"` |
| `is_active` | boolean | Whether your token is active |
| `has_quota` | boolean | Whether your plan has a quota limit |
| `reset_date` | string (ISO 8601 datetime) | When the current billing period started |
| `next_reset` | string (ISO 8601 datetime) | When your counter resets — always the 1st of next month |

---
sidebar:
  order: 30

### Response headers

| Header | Description |
|---|---|
| `X-API-Version` | `2.0` |
| `X-Quota-Limit` | Your monthly request limit |
| `X-Quota-Remaining` | Requests remaining this month |
| `X-Quota-Reset` | ISO 8601 timestamp of next quota reset |
| `X-Request-ID` | UUID for this request |

---
sidebar:
  order: 30

### Example response

```json
{
  "subscription": "Free",
  "monthly_limit": 1000,
  "current_usage": 27,
  "remaining": 973,
  "usage_percentage": 2.7,
  "status_level": "normal",
  "is_active": true,
  "has_quota": true,
  "reset_date": "2026-05-01T00:00:00Z",
  "next_reset": "2026-06-01T00:00:00Z"
}
```

---
sidebar:
  order: 30

### HTTP status codes

| Code | Meaning |
|---|---|
| `200 OK` | Success. |
| `401 Unauthorized` | Missing or invalid token. |
| `405 Method Not Allowed` | Only GET is supported. |
| `500 Internal Server Error` | Server error. Retry after a short delay. |

#### 401 — no Authorization header

```json
{
  "error": {
    "code": "auth_missing",
    "message": "Authentication credentials were not provided"
  }
}
```

#### 401 — invalid token

```json
{
  "error": {
    "code": "auth_token_unknown",
    "message": "Invalid token format"
  }
}
```
**Tip:** Quotas reset on the **first day of each calendar month** — not on a rolling 30-day basis. If you start using the API on April 17, your counter resets on May 1.