Rate Limits

The Mage Loyalty API enforces a rate limit of 6 requests per second per API key using a sliding window. Exceeding the rate limit returns a 429 Too Many Requests response:

{
  "errors": [
    {
      "status": "429",
      "title": "Too Many Requests",
      "detail": "Rate limit exceeded. Max 6 requests per second."
    }
  ]
}

Response headers

A 429 response includes headers that describe the limit and when you can retry:

Header	Description
`X-RateLimit-Limit`	The maximum number of requests allowed in the window
`X-RateLimit-Remaining`	The number of requests remaining in the current window
`X-RateLimit-Reset`	The time the current window resets, as a Unix timestamp in milliseconds
`Retry-After`	The number of seconds to wait before retrying

Best practices

Cache responses where possible to reduce the number of API calls
Use pagination to fetch large datasets in batches rather than making many parallel requests
Implement exponential backoff when you receive a 429 response
Use read-only keys for high-frequency read operations like storefront widgets

REST API

API Resources

Webhook Events

Shopify Metafields

Rate Limits

Rate limits

Response headers

Best practices

​Rate limits

​Response headers

​Best practices

Rate limits

Response headers

Best practices