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.

​
Installing the SDK

1

Install the SDK

bun add contiguity
2

Initialize the Client

import { Contiguity } from "contiguity";
const contiguity = new Contiguity("contiguity_sk_...your_token...");

​
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
required
The name of your application or service. This will be included in the OTP message as “Your [name] code is…“.

​
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.

​
otp.resend(params)

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

​
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)