Rate Limits
Health Gorilla enforces rate limits to protect system performance and ensure fair usage across tenants. These limits apply to both the FHIR API and auxiliary services such as authentication and document exports. Each environment may impose different constraints based on usage tier, licensing, and production readiness.
Environment-Specific Limits
| Environment | Rate Limit Type | Behavior |
|---|---|---|
| Sandbox | Informational only | Requests are tracked but not actively throttled |
| Production | Enforced by tenant | Requests exceeding contract thresholds return 429 |
Best Practices
- Use bulk operations (such as
$p360-retrieve) instead of issuing many granular queries. - Implement exponential backoff when retrying after a
429 Too Many Requestsresponse. - Avoid querying the same patient or document repeatedly without changes.
- Reuse access tokens within their lifetime instead of re-authenticating on every request.
Contact Health Gorilla Support if you believe your use case requires elevated limits or custom allowances.