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
    }