Subscription
Overview
The Subscription page lets you view your current plan and this period's usage, and manage plan changes (upgrade/downgrade), cancellation, and reactivation.
How to get here
- Top menu Settings → Left sub-menu Subscription
- Dashboard bottom Upgrade Plan quick link
Plans and monthly limits
Four plans are available, and the billing cycle for all plans is 30 days.
| Plan | Monthly limit | Price | Over-limit handling |
|---|---|---|---|
| Free | 1,000 | $0 | API calls rejected when limit is reached |
| Basic | 30,000 | $10/mo | API calls rejected when limit is reached |
| Pro | 300,000 | $30/mo | API calls rejected when limit is reached |
| Enterprise | 1,000,000 | $100/mo | Calls allowed beyond limit. Excess automatically billed next cycle |
Enterprise overage charges: Calls beyond the monthly limit are charged at $0.0005 per call, added to the next billing cycle (e.g., 10,000 calls over → $5 additional charge).
Usage card
The current subscription usage is displayed as a card at the top of the page.
- Current plan name and monthly limit
- Usage this period:
used / limitindicator and progress bar - Remaining calls or overage calls (Enterprise)
- Current period end date: Next billing/renewal date
Usage alerts
- At 80%: Email + Discord/Slack/Telegram alert (if configured)
- Over 100%: Email + alert sent. Free/Basic/Pro start blocking calls from this point
Plan change
Click the Change Plan button to see available plans. Plans above your current one are marked as Upgrade, and lower ones as Downgrade.
Upgrade
- Applied immediately
- The prorated difference is charged immediately for the remainder of the period
- API call limit is raised immediately
- Usage accumulated during this period is preserved, and counted against the new limit
- No limit on the number of upgrades
Downgrade
- Applied immediately
- Credit is issued for the remainder of the period (applied to the next billing)
- API call limit is lowered immediately
Downgrade constraints
Downgrade has two constraints. If either is not met, the downgrade is rejected.
1. Once per billing cycle
You can downgrade only once within the same billing cycle. If you've already downgraded, you can try again after the next billing renewal.
2. Usage-ratio allowance
If you've used too much of the target plan's limit so far, the downgrade is denied. The allowed usage is calculated as follows.
Allowed usage = min(
target plan limit × (days elapsed ÷ total cycle days) × 1.1,
target plan limit
)
In plain terms, the target plan's allowance scales with how much of the billing cycle has passed, with a 10% bonus buffer. In any case, it cannot exceed the target plan's full limit.
Example: Downgrading Pro (300,000) → Basic (30,000) on a 30-day cycle:
| Current time | Basic allowance | With current usage 5,000 |
|---|---|---|
| Day 5 of cycle | ~5,500 | Rejected |
| Day 15 of cycle | ~16,500 | Allowed |
| Day 25 of cycle | ~27,500 | Allowed |
| Day 30 of cycle | 30,000 (cap) | Allowed |
Immediate decisions:
- If current usage is 0, always allowed
- If current usage is already at or above the target plan's limit, immediately rejected
If downgrade is rejected
The reason is shown on screen.
- You've already downgraded this cycle — Retry after the next billing renewal
- Current usage exceeds allowed limit — Retry after the next billing renewal
Cancel subscription
Use the Cancel Subscription button to cancel a paid subscription.
- The service remains available until the current billing period ends
- After the period ends, you are automatically transitioned to the Free plan
- Production data is not deleted immediately — it continues under the Free plan policy after going through the regular archiving schedule
- You can still
Reactivateto undo the cancellation (only within the billing period)
Canceling scheduled cancellation
Due to Paddle's behavior, a subscription scheduled to cancel and a plan change cannot be used together. If cancellation is scheduled, the plan change button is disabled — you must reactivate first, then change the plan.
Payment method
Use the Update Payment Method button to refresh your card information. If an upgrade fails (e.g., expired card), update your card here and try again.
Enterprise — Overage history
If you're on the Enterprise plan, an Overage history section is shown additionally.
- View past billing cycles' overage call counts and charges
- Click View full history to see details
Troubleshooting
- Upgrade went through but payment failed: Your payment method may be expired or declined. Register a new card via
Update Payment Methodand try again - Downgrade button is disabled: You've either already downgraded this cycle, current usage exceeds the target plan limit, or cancellation is scheduled. Check the message on screen
- What happens to my data when I move to Free?: Not deleted immediately. The Free plan policy (endpoints auto-cleaned 7 days after creation) applies, and production data created during the subscription can still be downloaded from Archives. See Archives for details
- How do I get a refund?: Cancel your subscription while your account is active, and remaining period credit applies to the next billing. See the service refund policy page for details (e.g., full refund within 30 days if unused)
- My usage spiked suddenly: Check the Stats page for collaboration key-level breakdown to see which collaborator is driving traffic
- How do I delete my account?: If you need a refund, cancel your subscription on this page first, then delete the account on the Profile page. You can't access past billing info after account deletion