Guides

Budgets & 402

Set a monthly USD budget per virtual key. At 100% spend, the gateway rejects requests with HTTP 402.

Reset cycle

Budgets reset on the 1st of each month (UTC). Raise a cap anytime — it applies instantly.

Error shape

{
  "error": {
    "message": "Monthly budget exceeded",
    "type": "budget_exceeded",
    "code": "budget_exceeded"
  }
}