402 — Quota or budget exceeded

When HiWay refuses a request because a cap was hit.

A 402 has two flavors. Read the error.code field to know which one.

Case 1 — Monthly quota exceeded

json

{
  "error": {
    "code":              "quota_exceeded",
    "message":           "Monthly request quota reached (100,000 / 100,000).",
    "included_requests": 100000,
    "used_requests":     100000,
    "upgrade_url":       "https://www.hiway2llm.com/upgrade"
  }
}

You've used all your included requests for the month. Options: upgrade to the next plan, pay for overage ($4 / 100k on Build, $3 / 100k on Scale, $2 / 100k on Business — enable in Dashboard → Billing → Overage), or wait for the first of the month UTC.

Case 2 — Budget Control BLOCK verdict

json

{
  "error": {
    "code":       "budget_exceeded",
    "message":    "Monthly BYOK budget cap reached ($500.00 / $500.00).",
    "verdict":    "BLOCK",
    "cap_usd":    500.0,
    "spent_usd":  500.02,
    "reset_at":   "2026-05-01T00:00:00Z"
  }
}

Your upstream BYOK spend hit the cap you set in Dashboard → Budget Control. Raise the cap, or wait for the month reset.