Usage

GET /v1/usage

Get your current video-minute consumption, plan limits, and a per-operation breakdown for the billing period.

Example

curl https://api.vidocu.ai/v1/usage \
  -H "Authorization: Bearer vdo_live_your_key_here"

Response 200 OK

{
  "plan": "business",
  "period": {
    "start": "2026-06-01T00:00:00.000Z",
    "end": "2026-07-01T00:00:00.000Z"
  },
  "videoMinutes": {
    "used": 45.3,
    "limit": 60,
    "remaining": 14.7
  },
  "breakdown": {
    "apiCalls": 1542,
    "videoMinutes": 45.3,
    "exports": 12,
    "analyses": 28,
    "translations": 5,
    "helpArticles": 8,
    "voiceovers": 3,
    "toolExecutions": 4
  },
  "limits": {
    "videoMinutes": 60,
    "maxVideoDuration": 10,
    "requestsPerMinute": 60
  }
}

Response fields

Field	Type	Description
plan	string	Your Vidocu plan: free, pro, business, or enterprise
period.start	string	Billing period start
period.end	string | null	Billing period end (null for free/lifetime tracking)
videoMinutes.used	number	Video minutes used this period (shared with the app)
videoMinutes.limit	number	Monthly video minute limit (-1 = unlimited)
videoMinutes.remaining	number | null	Minutes left this period (null when unlimited)
breakdown	object | null	Per-operation API call counts (analytics only, not a billing source)
limits.videoMinutes	number	Monthly video minute limit (-1 = unlimited)
limits.maxVideoDuration	number	Max minutes per single video (-1/0 = unlimited)
limits.requestsPerMinute	number	Requests per minute (fixed at 60)

info

videoMinutes is the meter the API enforces against, and it's the same allowance the Vidocu app uses. The breakdown object is a per-operation tally for your own analytics.

Errors

Status	Code	Cause
401	authentication_error	Invalid or missing API key
403	limit_exceeded	API access requires the Business plan or higher