Rate limits

Current limits

The Clarify API doesn't enforce strict per-second rate limits, but we recommend:

• 25 records per batch for bulk create/update
• 1 second delay between batches
• 100 requests per minute for read endpoints

If you hit a rate limit, the API returns 429 Too Many Requests.

Handling 429 responses

Use exponential backoff:

async function fetchWithRetry(url, options, retries = 3) {
  for (let i = 0; i < retries; i++) {
    const res = await fetch(url, options);
    if (res.status === 429) {
      const delay = Math.pow(2, i) * 1000;
      await new Promise(r => setTimeout(r, delay));
      continue;
    }
    return res;
  }
  throw new Error('Rate limited after retries');
}

Bulk operations

For large imports, batch your records and add delays between batches. See the bulk operations guide for sizing recommendations.