Developer Documentation

Everything you need to integrate with the FundraiserMax API. Build custom workflows, sync donor data, and connect AI assistants to your fundraising platform.

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:

HeaderDescription
X-RateLimit-LimitMaximum number of requests allowed per window (e.g., 60).
X-RateLimit-RemainingNumber of requests remaining in the current window.
X-RateLimit-ResetUnix 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.