API Overview
Masivo implements rate limiting to ensure a stable and reliable API service for all customers. Rate limiting prevents abuse, guarantees fair usage, and helps maintain overall platform performance. There are two main rate limiters in place:- General Rate Limiter: Applies to all endpoints, protecting the system from excessive traffic and potential misuse.
- Migration Rate Limiter: Specifically applies to migration endpoints, which often handle large batch operations. This limiter ensures that migration processes do not overwhelm the system and are executed in a controlled manner.
Environment Differences
Every new account starts as a DEV account, which comes with certain limitations. In this environment, users can perform their integration tests for free. Once testing is complete, they can switch to PROD, keeping in mind that Masivo will start accumulating usage. To switch to PROD, please contact the support team. Below is a comparison of the rate limits for both environments:Adjusting Your Requests
If you experience throttling or delays due to rate limits, consider spread out your API calls over time rather than sending a burst of requests all at onceRate Limit Headers
When making requests to the API, you’ll receive the following headers in the response that provide information about your current rate limit status:
When you exceed the rate limit, you’ll receive a
429 Too Many Requests response code. In this case, the Retry-After header will indicate how long you should wait before retrying your request.