API Rate Limits
Understand SpherePay's API rate limits, how to manage them effectively, and how to request temporary increases to support your business needs.
To ensure the reliability and stability of our services, SpherePay enforces rate limits on all API requests. These limits help prevent misuse and ensure fair and consistent performance for all users. We periodically review and adjust these limits as necessary.
Need Higher Limits?
If your use case requires temporarily increased rate limits, please contact our support team.
Understanding Rate Limits
SpherePay’s API rate limits determine the maximum number of simultaneous requests per second (RPS) allowed from your applications. Below are our standard rate limits:
Customized Rate Limits
If you've arranged custom limits with our support team, your rate limits may differ from the defaults listed here.
| Operation | Description | Rate Limit |
|---|---|---|
| Read | HTTP GET requests used to retrieve data | 100 |
| Write | HTTP POST, PUT, PATCH, and DELETE requests used to modify data | 100 |
Load Testing Guidelines
We recognize that you might need to conduct load testing for your systems, especially ahead of high-traffic events or sales periods. While our sandbox environment supports testing functional integration, it is generally not suitable for load testing due to lower rate limits.
To perform load tests responsibly, we recommend simulating requests to SpherePay APIs using realistic latency parameters. If your integration is complex or requires dedicated load testing support, please reach out to our support team. We can assist by providing designated load testing windows or specialized sandbox environments when appropriate.
Planning Load Tests?
For assistance or to schedule a specific load testing arrangement, please contact our support team.
Best Practices for Managing API Rate Limits
- Monitor API Usage: Regularly track your request rates to stay within limits and avoid disruptions.
- Implement Exponential Backoff: Include retry logic with backoff strategies for handling rate limit errors gracefully.
- Efficient Caching: Cache data locally whenever feasible to reduce unnecessary API calls.
- Optimize Requests: Minimize API calls by batching requests or retrieving only essential data.
Following these guidelines ensures a seamless and reliable integration with SpherePay APIs.
Last updated on