Account

GET /v1/me

Cost · Free (control-plane endpoint)

{
  "data": {
    "id": "...", "email": "you@company.com",
    "plan_id": "monthly", "current_period_start": "2026-05-01T00:00:00.000Z",
    "status": "active",
    "plan": { "id": "monthly", "credits_per_cycle": 1000, "rate_limit_per_minute": 200 },
    "credits": { "balance": 842, "granted_this_cycle": 1000 }
  },
  "request_id": "..."
}

GET /v1/usage

Cost · Free (control-plane endpoint)

Query	Type	Notes
since	ISO timestamp	created_at >= since
limit	int	default 100, max 1000

{
  "data": [
    {
      "id": 91234, "endpoint": "/v1/properties/by-url",
      "actor": "detail", "units": 1, "status_code": 200,
      "created_at": "..."
    }
  ],
  "request_id": "..."
}

Credit balance

The dashboard reads your live credit balance via the Supabase RPC credit_balance(p_account_id). Programmatically, you can read your account row + recent ledger via supabase-js (signed in with your dashboard user JWT — not your API key). For API consumers, the worker returns 402 out_of_credits when balance hits zero — that’s the signal to top up.

Billing actions

Subscription and top-up purchases are dashboard-only flows. Sign in at https://zillapi.com/app/billing to:

• See current plan + balance + recent ledger
• Switch plans (Stripe Checkout)
• Buy top-up packs (paid plans only)
• Manage payment method / cancel (Stripe Customer Portal)