Skip to Content
Developers

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=42

Over 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=100 when you read whole lists.
  • Use updatedSince to read only what changed.
  • Spread scheduled jobs instead of running them all on the hour.
  • Back off on 429 and on 5xx, with jitter.

On this page