OnePath Connect
OnePath Connect
OnePath Connect Documentation
WebhooksError HandlingRate LimitsHIPAA for IntegratorsMedication Refill Lifecycle
Guides

Rate Limits

Understanding and working within OnePath rate limits.

Rate limits protect the platform for all partners. Every response includes rate limit headers.

Limits

EnvironmentRequests/minute
Sandbox1,000
Production100

Response Headers

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 87
X-RateLimit-Reset: 1722768000
  • X-RateLimit-Limit — your allowed requests per minute
  • X-RateLimit-Remaining — requests left in the current window
  • X-RateLimit-Reset — Unix timestamp when the window resets

Best Practices

  • Cache GET /insights responses — they're valid for 6 hours
  • Batch health data submissions instead of one observation at a time
  • Use webhooks instead of polling for async operations
  • Implement exponential backoff on 429 responses

Need higher limits? Contact partners@onepath.health to discuss your use case.

Error Handling

How to handle API errors gracefully in your integration.

HIPAA for Integrators

What HIPAA means for your OnePath integration, and what you need to do.

On this page

LimitsResponse HeadersBest Practices