This page states the rate limits that apply to an AliasFleet account: the per-minute allowance for each plan, the separate limits on login, password reset, sign-up, and verification resends, what the 429 Too Many Requests response means, and the steps that restore access and prevent repeat blocks.
This page states the account-level rate limit policy. Too Many Requests Error covers the 429 error itself and the steps that clear each kind of block. API Rate Limits by Plan covers the per-plan API allowances in detail. The three pages state the same numbers and differ in purpose, not in limits.
An AliasFleet account is required. The general allowance depends on the plan on the account. No special permission is needed to read the limits on this page.
What is rate limiting?#
Rate limiting is a cap on how many requests an account may make in a set time window. Any request that loads or changes data counts toward the cap: loading the alias list, creating or editing an alias, fetching sessions, loading destinations, checking activity, and checking billing or usage data. The cap stops one account, script, or automated guessing attempt from consuming shared capacity at the expense of other accounts.
Limits are measured per account, not per device. Requests from three open tabs on the same account all count toward the same allowance. Email forwarding runs on the server and is not subject to API rate limits, so aliases keep forwarding while an API block is active.
What are the rate limits by plan?#
The general allowance is measured over a rolling 60-second window and resets every 60 seconds.
| Plan | Requests per minute |
|---|---|
| Free | 50 |
| Pro | 100 |
| Business | 200 |
Ordinary use stays well below these allowances. Browsing aliases, managing destinations, and checking activity in a single tab issues only a handful of requests per page load, so a normal session does not approach 50 requests per minute even on the Free plan. The full per-plan detail, including what counts as a request, is in API Rate Limits by Plan.
What limits apply to sensitive actions?#
Sensitive actions have separate limits that apply across all plans. Upgrading the plan does not raise these limits, because they slow automated guessing and abuse rather than metering usage.
| Action | Limit |
|---|---|
| Login attempts | 5 attempts per 15 minutes per IP address, followed by a block of up to 10 minutes |
| Password reset requests | 3 per hour |
| Sign-up | 5 accounts per hour per IP address |
| Verification email resends | Limited; no numeric limit is stated for this action |
The login limit is measured per IP address, not per account, so repeated failed sign-in attempts from one address trigger the block even when the attempts target different accounts. The login block slows automated password guessing. A fuller description of credential-guessing attacks is in How Credential Stuffing Works.
What happens when a limit is reached?#
When the request rate passes the allowance, the server answers further requests with HTTP 429 Too Many Requests until the window resets. The error text normally reads "Too many requests" and states the remaining wait. Every 429 response also includes a Retry-After header stating how many seconds to wait before the next request.
General API blocks clear within 60 seconds, once the request rate falls back inside the allowance. Login blocks last up to 10 minutes, measured from the last failed attempt. Hitting a rate limit is temporary and automatic: the account is not flagged, penalised, or put at risk of suspension for hitting a limit occasionally. The step-by-step fix for each kind of block is in Too Many Requests Error.
How to stay inside the limits#
- Work in one tab. Extra tabs with AliasFleet open run background sync and add requests to the same per-account allowance.
- Stop requests during a block. Do not reload or retry while a block is active. Each new request is rejected as well, so retrying only lengthens the perceived delay.
- Wait out the full window. Wait 60 seconds for a general block, or up to 10 minutes for a login block, before trying again.
- Honour the
Retry-Afterheader in integrations. Wait at least the stated number of seconds before the next request, and increase the delay after each retry so each retry waits longer than the last. - Slow the request rate at the source. Batch operations where the API allows it, cache read-heavy responses, and poll on longer intervals instead of short continuous loops.
- Upgrade only when the general allowance is the constraint. A higher plan raises the per-minute allowance to 100 on Pro or 200 on Business. It does not raise the sensitive-action limits in the table above.
How to check whether a block has cleared#
- Close extra tabs and pause polling. Stop scripts, extensions, and other tabs that send requests to AliasFleet.
- Wait without retrying. Wait 60 seconds for a general block, or up to 10 minutes for a login block, measured from the last request or failed attempt.
- Reload once. After the wait, reload the page a single time and continue at a normal pace.
- Confirm normal responses return. If pages load and actions succeed, the block has cleared. If the 429 error returns at once, requests are still being sent from somewhere on the account.
What if the error keeps returning?#
| Symptom | Likely cause | Fix |
|---|---|---|
| 429 in the dashboard after rapid refreshes | Rolling per-minute limit exceeded | Wait 60 seconds, reload once |
| 429 on the login page | Repeated failed sign-in attempts from the IP address | Wait up to 10 minutes, sign in once |
| 429 from a script or integration | Requests above the plan allowance | Implement backoff, honour Retry-After |
| 429 that never clears | Requests still being sent | Close tabs, disable polling extensions, stop scripts |
| 429 on every action after an upgrade | Requests still above the new allowance | Slow the rate; the 60-second block still applies |
If the error persists after waiting and nothing on the account is issuing requests, open a support ticket so the cause can be investigated. The detailed troubleshooting steps for each symptom are in Too Many Requests Error.
See also: API Rate Limits by Plan · Too Many Requests Error