Skip to content

API

Request limits

There is a resend cooldown and rate limits on API token/IP.

Quick Answer

Do not spam send: keep a ~60 second pause per number and handle 429.

Summary

Resend to the same number — no more than ~1 time / 60 sec. There is an API rate limit. Verify may return 429.

Key Takeaways

  • Code TTL is usually 300 sec.
  • Code is 6 digits.
  • See errors and FAQ.

Default values (documentation)

Parameter Value
Code length 6 digits
Code TTL 300 sec (5 min)
Resend to a number ~1 time / 60 sec
Rate limit by token/IP present on the API side

Recommendations

  • Show a “send again” timer on the frontend.
  • Do not run verify in a loop without delay.
  • Log message, not raw OTP.

See send-otp, verify-otp, errors, pricing.