# My Quota

## GET /api/quantis/v3/me/quota/

Returns your account's tier, its usage this calendar month and its rate limit. Calling it does **not** count against your monthly quota, but it does count against your tier's rate limit.

Usage is per account: every key on your account adds to the same counter, so any of your keys returns the same numbers.

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

### Request

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

---

### Response

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

| Field | Type | Description |
|---|---|---|
| `tier` | object | Your current tier: `code` (e.g. `"pro"`) and `name` (e.g. `"Pro"`) |
| `monthly_quota` | integer or null | Requests included per calendar month. `null` when your tier has no monthly quota |
| `used` | integer | Requests counted this calendar month, across all your keys |
| `remaining` | integer or null | Requests left this month. `null` when your tier has no monthly quota |
| `usage_percentage` | number or null | `used / monthly_quota × 100`. `null` when your tier has no monthly quota |
| `status_level` | string | `"normal"` (under 70%), `"warning"` (70% or more), `"critical"` (90% or more) or `"exceeded"` (100% or more). Always `"normal"` when your tier has no monthly quota |
| `reset_at` | string (ISO 8601 datetime) | When your counter resets: the 1st of next month at 00:00, Caracas time |
| `rate_limit` | string | Your tier's rate limit as `<requests>/<period>`, e.g. `"60/m"` (`s` second, `m` minute, `h` hour, `d` day) |
| `expires_at` | string (ISO 8601 datetime) or null | When your current trial or paid period ends. `null` when it does not expire |

---

### Example response

```json
{
  "tier": {"code": "pro", "name": "Pro"},
  "monthly_quota": 50000,
  "used": 1234,
  "remaining": 48766,
  "usage_percentage": 2.5,
  "status_level": "normal",
  "reset_at": "2026-11-01T00:00:00-04:00",
  "rate_limit": "60/m",
  "expires_at": null
}
```

The values above are an example. See [center.quantis.vzla.io](https://center.quantis.vzla.io) for the current tiers.

---

### HTTP status codes

| Code | Meaning |
|---|---|
| `200 OK` | Success. |
| `401 Unauthorized` | Missing, invalid or revoked key. |
| `405 Method Not Allowed` | Only GET is supported. |
| `429 Too Many Requests` | Rate limit hit (`throttled`). Wait the seconds in the `Retry-After` header. See [Tiers and limits](/quantis/v3/tiers-and-limits/). |
| `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 key

```json
{
  "error": {
    "code": "auth_token_unknown",
    "message": "Invalid token format"
  }
}
```

#### 429: rate limit hit

```json
{
  "error": {
    "code": "throttled",
    "message": "Rate limit exceeded",
    "details": {
      "retry_after": 1
    }
  }
}
```
**Tip:** Quotas reset on the **1st of each calendar month** at 00:00 Caracas time, not on a rolling 30-day basis. If you start using the API on April 17, your counter resets on May 1.