Skip to content

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

    Create an API key

    Generate a token with OTP permission in the panel.

  2. 2

    Send the OTP

    POST the user’s phone number to /api/otp/send.

  3. 3

    User answers

    They hear the code and type it into your app.

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

Voice OTP versus 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
Read the full API reference
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 Started Today

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

Have more questions?

Our support team is available Sat–Thu, 10 AM – 7 PM.

+8809638461270
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.