# Mi Cuota

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

Devuelve el plan de tu cuenta, su uso en el mes calendario actual y su límite de velocidad. Llamarlo **no** cuenta contra tu cuota mensual, pero sí cuenta contra el límite de velocidad de tu plan.

El uso es por cuenta: todas las claves de tu cuenta suman al mismo contador, así que cualquiera de tus claves devuelve los mismos números.

| | |
|---|---|
| **Método** | `GET` |
| **URL** | `https://app.vzla.io/api/quantis/v3/me/quota/` |
| **Autenticación** | `Authorization: Bearer qapi_...` |
| **Parámetros** | Ninguno |

### Solicitud

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

---

### Respuesta

La respuesta de cuota es un **objeto plano**. No tiene envelope `data`/`meta`.

| Campo | Tipo | Descripción |
|---|---|---|
| `tier` | object | Tu plan actual: `code` (p. ej. `"pro"`) y `name` (p. ej. `"Pro"`) |
| `monthly_quota` | integer o null | Solicitudes incluidas por mes calendario. `null` cuando tu plan no tiene cuota mensual |
| `used` | integer | Solicitudes contadas este mes calendario, sumando todas tus claves |
| `remaining` | integer o null | Solicitudes restantes este mes. `null` cuando tu plan no tiene cuota mensual |
| `usage_percentage` | number o null | `used / monthly_quota × 100`. `null` cuando tu plan no tiene cuota mensual |
| `status_level` | string | `"normal"` (menos de 70%), `"warning"` (70% o más), `"critical"` (90% o más) o `"exceeded"` (100% o más). Siempre `"normal"` cuando tu plan no tiene cuota mensual |
| `reset_at` | string (datetime ISO 8601) | Cuándo se reinicia tu contador: el día 1 del próximo mes a las 00:00, hora de Caracas |
| `rate_limit` | string | El límite de velocidad de tu plan como `<solicitudes>/<período>`, p. ej. `"60/m"` (`s` segundo, `m` minuto, `h` hora, `d` día) |
| `expires_at` | string (datetime ISO 8601) o null | Cuándo termina tu período pagado actual. `null` cuando no vence |

---

### Ejemplo de respuesta

```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
}
```

Los valores de arriba son un ejemplo. Consulta [center.quantis.vzla.io](https://center.quantis.vzla.io) para ver los planes vigentes.

---

### Códigos de estado HTTP

| Código | Significado |
|---|---|
| `200 OK` | Éxito. |
| `401 Unauthorized` | Clave ausente, inválida o revocada. |
| `405 Method Not Allowed` | Solo se admite GET. |
| `429 Too Many Requests` | Límite de velocidad alcanzado (`throttled`). Espera los segundos del encabezado `Retry-After`. Ver [Planes y límites](/es/quantis/v3/tiers-and-limits/). |
| `500 Internal Server Error` | Error del servidor. Reintenta después de un momento. |

#### 401: sin encabezado Authorization

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

#### 401: clave inválida

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

#### 429: límite de velocidad alcanzado

```json
{
  "error": {
    "code": "throttled",
    "message": "Rate limit exceeded",
    "details": {
      "retry_after": 1
    }
  }
}
```
**Tip:** Las cuotas se reinician el **día 1 de cada mes calendario** a las 00:00, hora de Caracas, no en un período móvil de 30 días. Si empiezas a usar la API el 17 de abril, tu contador se reinicia el 1 de mayo.