429 Too Many Requests

Respect rate limits

If you are making API requests successively and your requests exceed the rate limits, a 429 Too Many Requests error is returned. See API Usage & Rate Limits for complete information about rate limiting.

The following best practices may help you avoid 429 errors:

  • Avoid constant polling by using webhooks to trigger updates
  • Cache your own data when storing specialized values or if you need to store very large data sets.
  • Use the modifiedTime query parameter to retrieve only updated data
  • If requesting data for multiple merchants, stagger your requests to avoid bursts of high traffic volume.
  • If backfilling data, make your requests during non-peak business hours.

Did this page help you?