Rate Limits

How to handle partner API throttling safely in production.

Partner endpoints enforce rate limits to protect service reliability.

Throttle Signal

When throttled, the API returns 429 Too Many Requests with:

• Retry-After
• X-RateLimit-Limit
• X-RateLimit-Remaining
• X-RateLimit-Reset

Retry Strategy

1. Respect Retry-After exactly.
2. Apply exponential backoff with jitter.
3. Reuse the same Idempotency-Key for retried writes.
4. Do not send parallel retries for the same business action.

Client Architecture Recommendations

• Use a client-side write queue or concurrency cap so retries stay controlled.
• Use token-bucket or leaky-bucket throttling in your client.
• Separate read and write retry policies.
• Trigger alerts when sustained 429 exceeds your SLO threshold.