Skip to main content
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.