Skip to main content
Contiguity offers a free OTP API that simplifies phone number verification using OTPs via SMS, which eliminates the need to develop custom logic. Gone are the days of paying for this simple feature.
Contiguity still bills you for the text messages on our Usage tier, includes them in Unlimited, and subtracts them from your quota if you’re on the Free tier.We don’t charge extra for the OTP API.

​
Sending and Verifying OTPs

1

Send an OTP

To verify a user’s phone number, you’ll first need to send them an OTP.
const res = await contiguity.otp.new({ 
    to: "+1234567890", 
    language: "en", 
    name: "MyApp" 
});
The name parameter is optional, but recommended. It customizes the message to say “Your [name] code is…”, e.g. “Your Twilio code is…”
2

Verify the Code

When your user inputs the code, verify it using the OTP ID from the previous step.
const res = await contiguity.otp.verify({ 
    otp_id: "otp_123", 
    otp: "123456" 
});
The verification will return a boolean (true/false). OTPs expire 15 minutes after sending.
3

Resend if Needed

If needed, you can resend an OTP using the original OTP ID.
const res = await contiguity.otp.resend({ 
    otp_id: "otp_123" 
});
Resending an OTP does not renew its expiry time.

​
Parameters

​
otp.new(params)

​
to
string
required
The recipient’s phone number in E.164 format (e.g., “+1234567890”).
​
language
string
required
The language code for the OTP message. See supported languages below.
​
name
string
Optional app name shown in the OTP message as “Your [name] code is…”.

​
Response

​
otp_id
string
Unique identifier for the generated OTP, used for verification and resending.
​
metadata
object
Request metadata including ID, timestamp, and API version.

​
otp.verify(params)

​
otp_id
string
required
The unique OTP identifier returned from the otp.new() call.
​
otp
string
required
The 6-digit verification code entered by the user.

​
Response

​
verified
boolean
Indicates whether the OTP was successfully verified. Returns true if valid, false if invalid or expired.
​
metadata
object
Request metadata including ID, timestamp, and API version.

​
otp.resend(params)

​
otp_id
string
required
The unique OTP identifier from the original otp.new() call.

​
Response

​
resent
boolean
Indicates whether the OTP was successfully resent to the original phone number.
​
metadata
object
Request metadata including ID, timestamp, and API version.

​
Reverse OTP

For reverse OTP flows use:
  • contiguity.otp.reverseInitiate(params)
  • contiguity.otp.reverseVerify(params)
  • contiguity.otp.reverseCancel(params)
See the Reverse OTP API reference for parameters and behavior.

​
Supported Languages

Contiguity currently supports 33 languages for OTPs, including: English (en), Afrikaans (af), Arabic (ar), Catalan (ca), Chinese / Mandarin (zh), Cantonese (zh-hk), Croatian (hr), Czech (cs), Danish (da), Dutch (nl), Finnish (fi), French (fr), German (de), Greek (el), Hebrew (he), Hindi (hi), Hungarian (hu), Indonesian (id), Italian (it), Japanese (ja), Korean (ko), Malay (ms), Norwegian (nb), Polish (pl), Portuguese - Brazil (pt-br), Portuguese (pt), Romanian (ro), Russian (ru), Spanish (es), Swedish (sv), Tagalog (tl), Thai (th), Turkish (tr), and Vietnamese (vi)