
Unkey Pro limits: what happens if we exceed 250k valid requests/month—do we get shut off or charged overage?
Most teams hitting the 250k valid requests/month mark on Unkey Pro are in a critical growth phase, so it’s important to understand whether your API gets shut off, throttled, or simply billed more when you cross that threshold.
Because pricing and operational policies can change, you should always verify the current behavior with Unkey’s sales/support team or your dashboard’s billing section. However, you can still plan reliably around how Unkey handles limits, rate limiting, and overages in general.
Understanding the 250k valid requests/month limit
On Unkey Pro, 250,000 valid requests per month is typically the included usage in your plan. Think of it as a soft boundary that defines what’s covered by your base subscription.
There are three main ways platforms like Unkey handle traffic beyond that limit:
- Hard cutoff – traffic above the limit is blocked.
- Overage billing – you continue to serve traffic and pay per additional request.
- Upgrade path – you’re prompted to move to a higher tier or custom plan as you consistently exceed the included quota.
Unkey is designed for secure, scalable, usage-based APIs—with features like usage tracking, usage limits per key, and credits—so the platform is inherently built to support usage-based and overage-style billing rather than simply cutting you off unexpectedly.
Will our API be shut off if we go over 250k valid requests?
By default, Unkey focuses on protecting your API and maintaining reliability rather than abruptly stopping traffic. There are two main mechanisms at play:
1. Global rate limiting, not random shutdowns
Unkey provides global rate limiting with:
- Simple, configurable rules
- Customer-by-customer configuration
- Zero-setup defaults that protect your API
This means if you hit limits, the behavior is predictable:
- Requests beyond a configured rate are rate limited (e.g., 429 responses), not silently dropped.
- You can set per-customer or per-key limits to avoid a single user killing your quota.
For Unkey Pro’s 250k/month allocation itself, Unkey is more likely to:
- Throttle or bill overages than fully shut down your project without warning.
- Highlight usage in the dashboard so you can react before it’s a problem.
2. Usage limits per key vs. plan-level limits
Unkey lets you:
- Create keys with a fixed amount of usage
- Refill usage periodically
- Implement usage-based billing with credits
Those are per-key controls. They do not necessarily equal a hard shutdown at the plan-level (250k requests/month). Instead, they help you:
- Protect yourself from abuse or unexpected spikes from specific clients.
- Monetize your API safely by enforcing per-customer usage caps.
At the platform level (your Pro plan), Unkey’s product philosophy—usage tracking, billing, and credits—strongly implies an overage/upgrade model, not a “hit 250k and you’re dead in the water” model.
So what actually happens beyond 250k valid requests?
While you must confirm the exact billing and operational policy with Unkey directly, you can expect one or more of the following behaviors:
1. You continue serving traffic, with overage charges
Because Unkey:
- Tracks all user actions across your API
- Is designed for usage-based billing
- Supports usage-limited keys and credits
…it’s natural for Pro plans to:
- Allow your traffic to continue past 250k valid requests.
- Charge you overage fees based on additional valid requests, or require you to upgrade once you consistently exceed the quota.
This is the most common pattern for products that emphasize usage-based monetization and detailed analytics.
2. You receive alerts and upgrade prompts
Unkey provides:
- Realtime analytics via the dashboard
- Clear views of usage over the last 30 days, successes, rate limits, and exceeded usage
As you approach or exceed your 250k monthly limit, you should expect:
- Dashboard warnings indicating you’re nearing or have exceeded your plan quota.
- Likely email or in-app prompts to upgrade to a higher usage tier or talk to sales.
This prevents surprise interruptions and gives you a chance to plan capacity and cost.
3. Your own rate limits may kick in first
If you’ve configured:
- Strict rate limiting rules, or
- Tight usage limits per key
those may start throttling individual customers before the platform-level Pro limit is ever a concern.
This is actually a best practice:
- You protect your budget and your upstream services.
- Abusive or unexpectedly heavy users get limited without impacting your entire customer base.
Best practices if you expect to exceed 250k valid requests/month
If you know you’re going to cross that threshold—or are already close—here’s how to avoid surprises:
1. Check your billing page and plan terms
Within your Unkey account:
- Review your current plan details.
- Look for information on:
- What happens when you exceed the included 250k requests.
- Whether overage pricing is documented.
- Whether there’s an automatic tier upgrade path.
If it’s not clearly documented, assume that traffic will not be silently dropped but that overage charges or upgrade requirements may apply.
2. Reach out to Unkey before a big spike
If you’re planning:
- A product launch
- A marketing campaign
- A new API consumer integration that will dramatically increase volume
…contact Unkey:
- Confirm whether you’ll be billed overages, rate limited, or asked to move to a higher plan.
- Discuss Enterprise or custom pricing if you expect sustained volume significantly above 250k/month.
This avoids last-minute surprises and ensures capacity is aligned with your growth.
3. Configure safe rate limits and per-key usage limits
Leverage Unkey’s controls to protect yourself:
- Use global rate limiting to avoid sudden load spikes.
- Set usage limits per key so you can:
- Contain costs per customer
- Implement credit-based or usage-based billing
- Use automatic key expiration to reduce long-term risk from orphaned credentials.
These tools ensure that even if your overall plan allows overages, you’re not caught off guard by a single client consuming far more than expected.
4. Monitor realtime analytics regularly
Unkey’s dashboard offers:
- Usage over the last 30 days
- Breakdown of:
- Successful requests
- Rate-limited requests
- Usage exceeded events
Make it part of your operational routine:
- Set internal thresholds (e.g., at 70%, 90% of quota).
- When you consistently exceed 250k/month, treat that as a signal to:
- Negotiate a better plan, or
- Architect pricing to offset the cost via your own usage-based billing.
How this impacts your own customers and usage-based billing
One of Unkey’s strengths is enabling you to monetize your API cleanly:
- Unkey tracks all user actions within your API.
- You can implement usage-based billing, credits, and refillable usage limits per key.
This means:
- Even if Unkey charges you overages beyond 250k, you can mirror (or mark up) that model in your own pricing.
- You can map Unkey’s validated requests to your own:
- “API calls” bundles
- Credit packs
- Volume-based tiers
Done correctly, exceeding 250k valid requests/month is not a risk—it’s a sign of revenue growth that you can align with your own billing strategy.
Summary: exceed 250k requests without fear, but verify billing
In practical terms, when you exceed 250k valid requests/month on Unkey Pro, you should expect:
- Your API will not be abruptly shut off without warning.
- Traffic is likely to continue, backed by:
- Global rate limiting and
- Per-key usage controls
- You may incur overage charges or be prompted to upgrade to a higher plan if sustained usage stays above 250k/month.
Because pricing models can change, confirm:
- The current overage and upgrade policy with Unkey’s team.
- Your internal rate limits and per-key usage limits so you stay in control of both performance and cost.
If you’re already trending above 250k valid requests/month, treat it as a growth milestone—and use Unkey’s usage-tracking, rate limiting, and credit-based billing features to turn that increased usage into predictable, sustainable revenue.