# Rate Limits

> Explains the main API rate limits, including minimum success rate, maximum active activations, endpoint request limits, and 429 block behavior.


## Rate limits

There are three different types of rate limits you should be aware of:

1. minimum success rate
2. maximum active activations
3. API endpoints maximum requests per time period

In the event of a block, you will receive a 429 error code, along with information on when block will expire.

### Minimum success rate

To prevent the scanning of phone numbers, a minimum success rate for receiving SMS messages is required to be maintained. If your success rate falls below 7%, your account will be subjected to a 24-hour block.

The success rate is calculated within a 24-hour window as follows:

```math
$$
\text{success rate} = \frac{\text{first SMS received by number}}{\text{total numbers ordered}} \times 100
$$
```




- The calculation of the success rate starts after the 10th number has been ordered.
- You have the option to unblock your account from within dashboard 3 times in 24 hours for specific service and country combinations.




> **Retail Customers Success Rate Note**


We may pause retail customer accounts to prevent abuse and ensure fair usage for all customers. You can change a customer's account status from the dashboard. The customer will be notified by email when their account is paused.



### Maximum active activations

To prevent abuse, the maximum number of active activations is limited to **20** by default. If you reach this limit, you will receive a 429 error code. You can cancel an active activation to free up space for a new one. If you need more than 20 active activations, please contact us.

