Rate Limits and Quotas

To ensure fair usage and maintain optimal performance for all healthcare API consumers, the vitalera API enforces rate limits on all endpoints. These limits are designed to support high-frequency remote patient monitoring data flows while protecting service availability for all organizations.

Rate Limits

Endpoint Category	Limit	Window
General API Calls	1000 requests per hour	Per hour
Authentication	100 requests per minute	Per minute
Data Retrieval	500 requests per hour	Per hour

Headers

Rate limit information is included in the response headers:

• X-RateLimit-Limit: The maximum number of requests allowed in the current window.
• X-RateLimit-Remaining: The number of requests remaining in the current window.
• X-RateLimit-Reset: The time at which the current rate limit window resets in UTC epoch seconds.

Handling Rate Limits

• Monitor Headers: Always check the rate limit headers to manage your request rate.
• Implement Retry Logic: Use exponential backoff when retrying requests after hitting rate limits.
• Optimize Requests: Batch requests where possible to minimize the number of API calls.

Exceeding Rate Limits

If you exceed the rate limits, the API will respond with a 429 Too Many Requests status code. You should handle this gracefully by implementing retry mechanisms.

Example Response:

{
  "type": "client_error",
  "errors": [
    {
      "code": "rate_limit_exceeded",
      "detail": "You have exceeded the rate limit. Please try again later.",
      "attr": null
    }
  ]
}