Developers · Rate limits

Generous by default, honest when you hit them.

Limits exist to keep every tenant’s p50 flat. When you hit one you get a clean 429 with a precise retry time, never a silent throttle.

Limits by tier

Handling a 429

backoff · TS

try {
  await qoyla.customer(id).safeToSpend();
} catch (e) {
  if (e.status === 429) {
    // Retry-After is always present and always honest
    await sleep(Number(e.headers["retry-after"]) * 1000);
  }
}