My Quota

GET /api/adcenter/v1/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/adcenter/v1/me/quota/`
Authentication	`Authorization: Bearer vzlaio_...`
Parameters	None

Request

curl --request GET \
  --url 'https://app.vzla.io/api/adcenter/v1/me/quota/' \
  --header 'Authorization: Bearer vzlaio_YOUR_TOKEN_HERE'

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"`, `"critical"`, or `"exceeded"`
`is_active`	boolean	Whether your token is active
`has_quota`	boolean	Whether you have requests remaining
`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

Example response

{
  "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-09-01T00:00:00Z",
  "next_reset": "2026-10-01T00:00:00Z"
}

HTTP status codes

Code	Meaning
`200 OK`	Success.
`401 Unauthorized`	Missing or invalid token.
`403 Forbidden`	Token was issued for a different vzla.io API.
`405 Method Not Allowed`	Only GET is supported.
`500 Internal Server Error`	Server error. Retry after a short delay.

401 — no Authorization header

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

401 — invalid token

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

Complete documentation as plain text for AI tools (llms.txt)