Developer API Documentation

Welcome to the OTP Gateway developer portal. Our REST APIs allow you to trigger high-speed OTP validations for mobile numbers in India. We support direct SMS routing and WhatsApp delivery options.

Authentication

All API requests must include your API Key in the request header as a Bearer Token.

Authorization: Bearer ak_YOUR_API_KEY

Send SMS OTP

Request Body Parameters

Send WhatsApp OTP

Request Body Parameters

After the user enters the OTP received on their mobile, call this endpoint to verify it. Uses the request_id returned from /send/sms or /send/whatsapp. Works for both SMS and WhatsApp OTPs.

Request Body Parameters

Send Bulk SMS Campaign

Trigger high-speed bulk SMS campaigns to multiple contacts. Estimated costs are deducted upfront from your wallet balance. Invalid or unroutable numbers will be automatically refunded by the provider after delivery report aggregation.

Request Body Parameters

Code Examples

curl -X POST https://otpwallah.in/api/v1/send/sms \
  -H "Authorization: Bearer ak_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "mobile": "9876543210",
    "length": 6
  }'

curl -X POST https://otpwallah.in/api/v1/verify \
  -H "Authorization: Bearer ak_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "request_id": "sms_550e8400-e29b-41d4-a716-446655440000",
    "otp": "482910"
  }'

curl -X POST https://otpwallah.in/api/v1/bulk-sms \
  -H "Authorization: Bearer ak_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Promo Campaign",
    "message": "Check out our services!",
    "contacts": ["9876543210", "9123456789"]
  }'

<?php
$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => "https://otpwallah.in/api/v1/send/sms",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => "POST",
    CURLOPT_POSTFIELDS => json_encode([
        "mobile" => "9876543210",
        "length" => 6
    ]),
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer ak_YOUR_API_KEY",
        "Content-Type: application/json"
    ],
]);
$response = json_decode(curl_exec($curl), true);
curl_close($curl);
$request_id = $response['request_id'];

<?php
$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => "https://otpwallah.in/api/v1/verify",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => "POST",
    CURLOPT_POSTFIELDS => json_encode([
        "request_id" => $request_id,
        "otp"        => $_POST['otp']
    ]),
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer ak_YOUR_API_KEY",
        "Content-Type: application/json"
    ],
]);
$verify = json_decode(curl_exec($curl), true);
curl_close($curl);
if ($verify['status']) { /* OTP matched! */ }
?>

<?php
$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => "https://otpwallah.in/api/v1/bulk-sms",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => "POST",
    CURLOPT_POSTFIELDS => json_encode([
        "title"    => "Promo Campaign",
        "message"  => "Check out our services!",
        "contacts" => ["9876543210", "9123456789"]
    ]),
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer ak_YOUR_API_KEY",
        "Content-Type: application/json"
    ],
]);
$response = json_decode(curl_exec($curl), true);
curl_close($curl);
if ($response['status']) { /* Campaign sent! */ }
?>

use Illuminate\Support\Facades\Http;

$response = Http::withToken('ak_YOUR_API_KEY')
    ->post('https://otpwallah.in/api/v1/send/sms', [
        'mobile' => '9876543210',
        'length' => 6,
    ]);

$requestId = $response->json('request_id');
// Store $requestId in session for verification

$verify = Http::withToken('ak_YOUR_API_KEY')
    ->post('https://otpwallah.in/api/v1/verify', [
        'request_id' => session('otp_request_id'),
        'otp'        => $request->input('otp'),
    ]);

if ($verify->json('status')) {
    // ✅ OTP matched — proceed with login/action
} else {
    // ❌ show error: $verify->json('message')
}

use Illuminate\Support\Facades\Http;

$response = Http::withToken('ak_YOUR_API_KEY')
    ->post('https://otpwallah.in/api/v1/bulk-sms', [
        'title'    => 'Promo Campaign',
        'message'  => 'Check out our services!',
        'contacts' => ['9876543210', '9123456789'],
    ]);

if ($response->json('status')) {
    // ✅ Campaign sent!
}

const axios = require('axios');

const { data } = await axios.post('https://otpwallah.in/api/v1/send/sms', {
    mobile: '9876543210',
    length: 6
}, {
    headers: {
        'Authorization': 'Bearer ak_YOUR_API_KEY',
        'Content-Type': 'application/json'
    }
});
const requestId = data.request_id;

const result = await axios.post('https://otpwallah.in/api/v1/verify', {
    request_id: requestId,
    otp: userEnteredOtp
}, {
    headers: {
        'Authorization': 'Bearer ak_YOUR_API_KEY',
        'Content-Type': 'application/json'
    }
});

if (result.data.status) {
    console.log('OTP Verified!', result.data.verified_at);
} else {
    console.error('Failed:', result.data.code);
}

const result = await axios.post('https://otpwallah.in/api/v1/bulk-sms', {
    title: 'Promo Campaign',
    message: 'Check out our services!',
    contacts: ['9876543210', '9123456789']
}, {
    headers: {
        'Authorization': 'Bearer ak_YOUR_API_KEY',
        'Content-Type': 'application/json'
    }
});

Error Codes