Account & usage

Read your plan, limits, remaining credits and usage for the current cycle.

Account#

GET/v1/accountfree
200 OK
{
  "plan": { "id": "free", "name": "Free", "monthly_credits": 250, "rate_per_second": 5, "concurrency": 2 },
  "available_credits": 249,
  "cycle_started_at": "2026-10-01T00:00:00.000Z",
  "cycle_resets_at": "2026-11-01T00:00:00.000Z"
}

Usage#

GET/v1/account/usagefree
Example
curl https://new-project-rho-ecru.vercel.app/v1/account/usage \
  -H "Authorization: Bearer vd_live_…"
200 OK
{ "available_credits": 249, "credits_used_this_cycle": 1, "requests_this_cycle": 1, "cycle_resets_at": "2026-11-01T00:00:00.000Z" }

Every /v1/verify response also carries x-credits-remaining, so most integrations never need to poll usage.

Related