Skip to main content

​
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. Please retry after a short delay."
    }
  ]
}

​
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