Check usage

Read the calling key's current quota state. Free, does not consume a credit. Useful for displaying “you have N credits remaining” in SDK tooling before submitting bulk work.

GET/api/v1/usage

Request

bash

curl -H "Authorization: Bearer yvt_live_..." \
  "https://api.youtubevideotranscript.io/api/v1/usage"

Response 200

json

{
  "plan": "pro",
  "subscription_status": "active",
  "transcripts_used": 342,
  "transcripts_total": 5000,
  "transcripts_remaining": 4658,
  "billing_cycle_start": "2026-04-21T00:00:00.000Z"
}

Response fields

plan: one of free, starter, pro, business.
subscription_status: one of active, inactive, past_due, canceled, expired.
transcripts_used / transcripts_total / transcripts_remaining: shared credit counts for the current cycle. These existing field names are retained for compatibility; usage includes transcripts, comments pages, and active job reservations across the website, API, and MCP. A reservation reduces the remaining balance before its results are complete; unused credits return when the job settles.
billing_cycle_start: ISO timestamp for the start of the quota period the counts above cover. On a paid plan that is the Stripe billing cycle. On the free plan it is the start of the current free cycle, which renews every 30 days.

Errors

No endpoint-specific errors. The global 401, 429, and 5xx responses apply. See Errors.