Voice OTP
Voice OTP API: deliver one-time passwords by phone call
When an SMS does not arrive, a phone call does. Hello PBX calls your user and reads the code digit by digit in Bangla or English.
Quick answer
What is voice OTP?
Voice OTP is a one-time password delivered by an automated phone call instead of SMS. The user answers, hears the code read out digit by digit, and types it into your app. It works on any phone, including basic feature phones, and is a reliable fallback when SMS is delayed or blocked.
- Codes read in Bangla or English
- Your own intro and outro recordings
- Simple REST API: send, verify, check status
What you get with Voice OTP
-
Send and verify
One call to send the code, one to verify what the user typed.
-
Bangla and English digits
Clear, natural recordings of every digit.
-
Custom intro and outro
Upload your own greeting, repeat and closing messages.
-
Expiry control
Set how many minutes a code stays valid (1–30).
-
Generate or bring a code
Let us create the code or pass your own 4–8 digit code.
-
Status lookup
Check whether a code was sent, verified or expired.
How it works
How it works
-
1
Create an API key
Generate a token with OTP permission in the panel.
-
2
Send the OTP
POST the user’s phone number to /api/otp/send.
-
3
User answers
They hear the code and type it into your app.
-
4
Verify
POST the otp_id and code to /api/otp/verify.
Use cases
Where businesses use it
- Login and sign-up
- Verify phone numbers when users register.
- Checkout
- Confirm cash-on-delivery buyers before shipping.
- Password reset
- A fallback when the SMS code does not arrive.
Compare
Voice OTP compared with SMS OTP
| Features |
Voice OTP
Hello PBX
|
SMS OTP
|
|---|---|---|
| Works on feature phones | ✓ Yes | ✓ Yes |
| Affected by SMS filtering or delays | ✕ No | ✓ Yes |
| Usable by people who cannot read the text | ✓ Yes | ✕ No |
| User must answer a call | ✓ Yes | ✕ No |
For developers
Send a voice OTP with one request
Generate an API token in your panel, then call the endpoint from any language. The user’s phone rings and the code is read out digit by digit.
- ✓ Codes read in Bangla or English
- ✓ Set expiry from 1 to 30 minutes
- ✓ Verify with the returned otp_id
curl -X POST https://pbx.itfair.bd/api/v1/otp/send \n -H "Authorization: Bearer $TOKEN" \n -H "Accept: application/json" \n -d phone_number=01XXXXXXXXX \n -d ttl_minutes=5
# → 200 OK
{
"status": "dispatched",
"otp_id": 1234,
"expires_at": "2026-09-26T10:05:00+00:00"
}
$res = Http::withToken($token)
->acceptJson()
->post('https://pbx.itfair.bd/api/v1/otp/send', [
'phone_number' => '01XXXXXXXXX',
'ttl_minutes' => 5,
]);
$otpId = $res->json('otp_id'); // keep it to verify
const res = await fetch('https://pbx.itfair.bd/api/v1/otp/send', {
method: 'POST',
headers: {
Authorization: `Bearer ${TOKEN}`,
'Content-Type': 'application/json',
Accept: 'application/json',
},
body: JSON.stringify({ phone_number: '01XXXXXXXXX', ttl_minutes: 5 }),
});
const { otp_id } = await res.json();
import requests
res = requests.post(
'https://pbx.itfair.bd/api/v1/otp/send',
headers={'Authorization': f'Bearer {TOKEN}', 'Accept': 'application/json'},
data={'phone_number': '01XXXXXXXXX', 'ttl_minutes': 5},
)
otp_id = res.json()['otp_id']
Get a price for Voice OTP
Tell us your volume and we will send a quote, or see the plans that include voice services.
FAQ
Frequently asked questions
Which languages are supported?
Digits are read in Bangla or English. Your intro and outro messages can be in any language you record.
Can I send my own code?
Yes. Pass a 4 to 8 digit code in the request, or leave it out and we generate one.
How long is a code valid?
You set the expiry between 1 and 30 minutes. The default is 10 minutes.
How do I get the otp_id to verify?
The send request returns an otp_id. Store it and send it with the user’s code to the verify endpoint.
Explore
Related solutions
- Developer API Hello PBX REST API reference: authentication, Voice OTP, click-to-call, auto calls and SMS endpoints with PHP, Node, Python and cURL examples.
- WooCommerce Plugin Send order SMS and verify buyers with voice OTP in WooCommerce. Download the Hello PBX plugin, follow the install steps and connect your API key.
- Bulk SMS Service Send bulk SMS in Bangla or English to any operator in Bangladesh from the Hello PBX panel or SMS API. Low per-SMS price and full delivery reports.
- Auto Calling Send automated voice calls for payment reminders, appointments, delivery updates and surveys. Hello PBX auto calling reports every answer and key press.