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
requestsToday	integer	Requests counted since 00:00 UTC today, across every key on the account.
dailyLimit	integer	Requests allowed per UTC day. Paid plans are capped per day, the trial per month; null when there is no daily cap.

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": null,
  "rateLimitPerMinute": 60,
  "requestsToday": 431,
  "dailyLimit": 2000
}