API Rate Limits and Best Practices



Rate Limits



| Plan | Requests/Minute | Requests/Day | |------|-----------------|--------------| | Free | 30 | 1,000 | | Pro | 120 | 10,000 | | Business | 600 | 100,000 |

Rate Limit Headers



Every API response includes: 
X-RateLimit-Limit: 120
X-RateLimit-Remaining: 115
X-RateLimit-Reset: 1680000000


When You Hit the Limit



  • •Response: 429 Too Many Requests
  • •Wait until the reset time, then retry
  • •Implement exponential backoff in your code


    • Best Practices



  • 1.Cache responses — don't fetch the same data repeatedly
  • 2.Use webhooks instead of polling for real-time updates
  • 3.Batch requests where possible
  • 4.Paginate large result sets (default: 50 per page)
  • 5.Handle 429s gracefully — queue and retry


    • Pagination



    GET /api/v1/tickets?page=2&limit=50


    Response includes:
    json
    {
  "total": 200,
  "page": 2,
  "pages": 4,
  "limit": 50
}