Check usage

Read the calling key's current quota state. Free, does not consume a credit. Useful for displaying “you have N transcripts 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: current cycle counts.
billing_cycle_start: ISO timestamp, or null for free-plan accounts that have no billing cycle.

Errors

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