Quota state for the calling key

GET/v1/usage

Returns the current billing period, how many requests the key has spent and when the counter resets. Cheap to poll; it does not count against the quota itself.

Parameters

This endpoint takes no parameters.

Response

Field	Type	Description
plan	string
periodStart	string (ISO 8601)
periodEnd	string (ISO 8601)
requests	integer	Requests counted in this period.
limit	integer	Requests allowed in the period. Null when the plan is uncapped.
rateLimitPerMinute	integer

Errors

Status	Code	When
401	invalid_key	The key is missing, unknown or disabled.

Example

curl https://clips.vocaflare.com/v1/usage \
  -H "Authorization: Bearer $VOCAFLARE_API_KEY"

{
  "plan": "starter",
  "periodStart": "2026-09-01T00:00:00Z",
  "periodEnd": "2026-10-01T00:00:00Z",
  "requests": 12840,
  "limit": 50000,
  "rateLimitPerMinute": 120
}