Skip to content

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.

MethodGET
URLhttps://app.vzla.io/api/quantis/v3/me/quota/
AuthenticationAuthorization: Bearer qapi_...
ParametersNone

Request

Terminal window
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.

FieldTypeDescription
tierobjectYour current tier: code (e.g. "pro") and name (e.g. "Pro")
monthly_quotainteger or nullRequests included per calendar month. null when your tier has no monthly quota
usedintegerRequests counted this calendar month, across all your keys
remaininginteger or nullRequests left this month. null when your tier has no monthly quota
usage_percentagenumber or nullused / monthly_quota × 100. null when your tier has no monthly quota
status_levelstring"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_atstring (ISO 8601 datetime)When your counter resets: the 1st of next month at 00:00, Caracas time
rate_limitstringYour tier’s rate limit as <requests>/<period>, e.g. "60/m" (s second, m minute, h hour, d day)
expires_atstring (ISO 8601 datetime) or nullWhen your current trial or paid period ends. null when it does not expire

Example response

{
"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 for the current tiers.


HTTP status codes

CodeMeaning
200 OKSuccess.
401 UnauthorizedMissing, invalid or revoked key.
405 Method Not AllowedOnly GET is supported.
429 Too Many RequestsRate limit hit (throttled). Wait the seconds in the Retry-After header. See Tiers and limits.
500 Internal Server ErrorServer error. Retry after a short delay.

401: no Authorization header

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

401: invalid key

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

429: rate limit hit

{
"error": {
"code": "throttled",
"message": "Rate limit exceeded",
"details": {
"retry_after": 1
}
}
}
Complete documentation as plain text for AI tools (llms.txt)