SKULabs enforces several bucket-based rate limits that you may encounter while using our API. Additionally, some endpoints have special rate limits or account-level locks to prevent abuse of bulk endpoints.

​
Per-api-key limits

You are limited to 2 requests per second per API key.

​
Per-account limits

You are limited to your plan’s associated rate limit, broken up into hourly buckets. As of August 2024:

  • Basic - 1000/day in buckets of 41/hour
  • Premium - 100 000/day in buckets of 4 166/hour
  • Enterprise - 300 000/day in buckets of 12 500/hour
  • Enterprise 2X (Paid) in buckets of 25 000/hour
  • Enterprise 4X (Paid) in buckets of 50 000/hour

​
Endpoint limits

It is rare, but certain endpoints have custom rate limits, you may need to dynamically wait in these cases.

​
Endpoint locks

Some endpoints have locks that prevent multiple requests from being processed simultaneously by API for the entire account. These are typically actions like bulk_reconcile, bulk_delete, or bulk_receive. You should queue and wait for each request to finish or implement an exponential fallback algorithm and resubmit your requests until you receive a 200, 202, or 203 status code.

​
Dynamically waiting for rate limit resets.

If your 429 error contains an error object, you can wait error.data.wait_seconds seconds for your rate limit bucket to reset.

{ "error": { "message": "Rate limited. You are allowed etc...", data: { "wait_seconds": 8 } } }
This number can be up to an hour or longer. Do not arbitrarily sleep your program in response to this error.
Your First API CallHandling Status Codes