Developer Documentation
API Rate Limits
FundraiserMax API rate limits, the response headers that report your remaining quota, and what to do when a request is rate-limited.
Rate Limits
The default rate limit is 60 requests per minute per API key. Rate limits are set by FundraiserMax. If your integration needs a higher limit, contact support.
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.