Documentation menu
billingplans

Billing & Plans

Understand ScryWatch's pricing tiers, upgrade your plan, manage your subscription, and control usage limits with the hard cap.

Billing & Plans

ScryWatch offers a free tier and paid plans for teams that need higher event volumes, more AI summaries, and additional features.

Step 1: View your current plan

Click Billing in the left sidebar (or navigate from Org Settings → Billing).

The billing page shows:

  • Current plan — Free, Starter, Growth, or Scale
  • Plan status — Active, Past Due, or Canceled
  • Current period end — when the current billing cycle ends
  • Usage — log events and AI summaries used this period vs. your plan limits
  • Overage estimate — projected extra charges if you’re on an overage-enabled plan

Step 2: Understand the plans

PlanMonthly eventsAI summariesPrice
Free50,00010$0
Starter1,000,000200$12/mo
Growth10,000,0002,000$39/mo
Scale50,000,00010,000$99/mo

Events beyond your plan limit are billed as overages at $2.00 per 1,000,000 logs (unless the hard cap is enabled). The Free plan has no overage option — it always hard-caps at its limit.

Step 3: Upgrade your plan

Click Upgrade Plan and select the plan tier you want.

You’ll be redirected to Stripe Checkout to enter payment information. After completing payment, your plan upgrades immediately.

Note: Only Admins and Owners can upgrade the plan.

Step 4: Manage your subscription

Click Manage Subscription to open the Stripe Customer Portal.

From the portal you can:

  • Update your payment method
  • View and download invoices
  • Cancel your subscription
  • Change your billing email

Step 5: Enable the hard cap

By default, ScryWatch continues accepting events beyond your plan limit and bills overages.

Toggle Hard Cap to ON to stop accepting events once you reach your monthly limit. No overages will be charged, but events will be rejected with a 402 Payment Required response (error: "usage_limit_exceeded") until the next billing period.

Note: A 429 Too Many Requests response means something different — that’s ScryWatch’s IP-based rate limiter kicking in on a burst of requests, not the billing usage limit. The usage limit always returns 402.

Tip: Enable the hard cap for non-production projects where you want to control spend. Keep it off for production projects where missing events would be worse than an overage charge.

Step 6: Handle a past-due subscription

If your payment fails, your plan status changes to Past Due. ScryWatch continues working for a grace period, but you should update your payment method promptly.

Click Manage Subscription and update your payment method in the Stripe portal. After a successful payment, the status returns to Active.

You’re done

You now know how to:

  • View your current plan and usage
  • Upgrade to a higher tier
  • Manage your subscription and payment method via Stripe
  • Enable the hard cap to prevent overage charges

Billing status, checkout, and hard cap toggle are available via the billing API for programmatic management.