Our API enforces rate limits to ensure system stability and prevent abuse. These limits control the number of requests that can be made within a given time frame.

General Limits

Each client can make up to 5,000 requests per hour across most endpoints. This limit is applied dynamically over a rolling 60-minute window. Some endpoints enforce stricter limits — see Endpoint-Specific Rate Limits below.

If you exceed this limit, you will receive a 429 Too Many Requests response and must wait before sending additional requests.

Endpoint-Specific Rate Limits

Some endpoints have lower rate limits than the general 5,000 requests/hour threshold. These limits are enforced independently and may trigger 429 errors even when your overall request count is well below the general limit.

Endpoint	Notes
`POST /reports/detailed`	Subject to a stricter per-endpoint limit. Avoid high-frequency automated calls to this endpoint.

If you are building automated workflows that call these endpoints at scale, incorporate per-endpoint backoff logic in addition to your general rate limit handling.

Handling Rate Limit Responses

If your application surpasses the allowed request rate, the API will respond with:

HTTP Status Code: 429 Too Many Requests
Retry-After Header: Specifies the number of seconds to wait before making another request.

It is essential to handle these responses properly to prevent disruptions in your integration.

Best Practices for Efficient API Usage

To ensure smooth operation within the rate limits, follow these recommendations:

Optimize request frequency. Avoid unnecessary API calls and batch operations when possible.
Respect the Retry-After header. If you receive a 429 Too Many Requests response, wait for the specified time before retrying.
Reduce excessive polling. Check the endpoint documentation for recommended update intervals instead of making frequent requests.
Implement exponential backoff. If you hit the rate limit, increase the wait time progressively before attempting another request.
Check endpoint-specific limits. The general 5,000 requests/hour limit does not apply to all endpoints. High-cost endpoints like POST /reports/detailed may enforce lower individual limits regardless of your overall usage.