Rate limits
How limits are reported and how to stay within them.
Every key has a request quota. Responses report where you stand with the RateLimit header (the values below are an example):
RateLimit: limit=600, remaining=598, reset=42Over the quota, the API answers 429 with a Retry-After header in seconds. Wait that long, then retry.
Stay within the limits
- Batch writes: send up to 100 redemptions or products per call instead of one per call.
- Page with
limit=100when you read whole lists. - Use
updatedSinceto read only what changed. - Spread scheduled jobs instead of running them all on the hour.
- Back off on
429and on5xx, with jitter.