Headers
Every response (success or error) carries:When you exceed it
The API returns429 Too Many Requests with the rate_limit.exceeded error
code and a Retry-After header (seconds to wait).
Recommended handling
- Watch
X-RateLimit-Remainingand throttle proactively before hitting0. - On
429, waitRetry-Afterseconds, then retry with the sameIdempotency-Keyfor writes. - Spread bulk catalogue reads; do not parallelize aggressively from one key.