NetSuite API Retry Backoff Wait Time Calculator

The formula

Delay for attempt n equals the initial delay multiplied by the factor to the power n minus one. The sum of a geometric series gives the total: initial delay x (factor^retries - 1) / (factor - 1). With a 2 second start, a factor of 2 and six retries, delays are 2, 4, 8, 16, 32 and 64 seconds, for 126 seconds of waiting. Jitter randomises each delay so many clients do not retry at the same moment, which on average cuts the wait roughly in half for full jitter.

• Delay n = base x factor^(n - 1)
• Total = base x (factor^retries - 1) / (factor - 1)
• Full jitter: random value between 0 and the delay
• Worst case adds timeout for each attempt

Common mistakes

Retrying on every error type is wrong. Retry concurrency, rate limit and transient network errors, but not validation errors or missing records, which will fail every time. Another mistake is retrying non-idempotent writes without an external ID, which creates duplicates. Finally, forgetting a retry ceiling can leave a job running for hours.

• Retry only transient errors
• Use an external ID or idempotency key on creates
• Log each attempt with the delay used
• Alert when retries are exhausted

Frequently Asked Questions