Developer Documentation
API Rate Limits
Understand FundraiserMax API rate limits, response headers, and best practices for handling rate-limited requests.
Rate Limits
API requests are rate-limited to ensure fair usage and platform stability. The default rate limit is 60 requests per minute per API key.
Rate Limit Headers
Every API response includes the following headers to help you manage your request rate:
| Header | Description |
|---|---|
X-RateLimit-Limit | Maximum number of requests allowed per window (e.g., 60). |
X-RateLimit-Remaining | Number of requests remaining in the current window. |
X-RateLimit-Reset | Unix timestamp (seconds) when the rate limit window resets. |
Exceeding the Limit
When you exceed the rate limit, the API returns a 429 Too Many Requests response. The response body includes a retryAfter field indicating how many seconds to wait before retrying.
{
"statusCode": 429,
"error": "Too Many Requests",
"message": "Rate limit exceeded. Please retry after 42 seconds.",
"retryAfter": 42
}Best practice: Implement exponential backoff in your client. When you receive a 429 response, wait the number of seconds specified in
retryAfter before making another request.