API Documentation

Introduction

Welcome to the EASY OTP developer reference guides. Our platform provides high-availability REST APIs designed to dispatch dynamically generated verification codes via Gmail SMTP and Carrier SMS securely.

Zero-Paperwork KYC

All services are instantly accessible upon sign-up. Get ₹5 free trial, then top up via UPI (min ₹15) and start sending OTPs.

Gmail OTP

₹0.10 per API call

SMS OTP

₹0.35 per API call

Gmail OTP API

Securely dispatch transactional OTP verification emails directly to primary inboxes. Each request dynamically styles your custom Sender Company Name on our SMTP servers.

POST /api/gmail/send-otp
ParameterTypeRequiredDescription
apiKeyStringYesYour Gmail Secret key
emailStringYesRecipient's valid email address
cURL 
curl -X POST https://easyotpapi.online/api/gmail/send-otp \
  -H "Content-Type: application/json" \
  -d '{"apiKey": "gmail_xxxxxxxxxxxxxxxx", "email": "user@gmail.com"}'

Response Examples

Success (200 OK) 
{
  "success": true,
  "message": "Gmail OTP dispatched successfully."
}
Error (400 Bad Request) 
{
  "success": false,
  "message": "Invalid API key or email address."
}
POST /api/gmail/verify-otp
ParameterTypeRequiredDescription
apiKeyStringYesYour Gmail API key
emailStringYesRecipient's email address
otpStringYes6-digit OTP code
cURL 
curl -X POST https://easyotpapi.online/api/gmail/verify-otp \
  -H "Content-Type: application/json" \
  -d '{"apiKey": "gmail_xxxxxxxxxxxxxxxx", "email": "user@gmail.com", "otp": "592038"}'

Response Examples

Success (200 OK) 
{
  "success": true,
  "message": "OTP Verified successfully."
}
Error - Invalid OTP (400) 
{
  "success": false,
  "message": "Invalid OTP code."
}
Error - Expired (400) 
{
  "success": false,
  "message": "OTP expired or session not found."
}

SMS OTP API

Dispatch verification codes through standard carrier telecommunication routes (SMS) to Indian numbers instantly. Highly compatible with legacy web services.

POST /api/sms/send-otp

Important Requirement

Send strictly 10-digit mobile number. Do NOT add +91 prefix. The gateway appends country code automatically.

ParameterTypeRequiredDescription
apiKeyStringYesYour SMS Gateway API key
numberStringYesRecipient's 10-digit mobile number
cURL 
curl -X POST https://easyotpapi.online/api/sms/send-otp \
  -H "Content-Type: application/json" \
  -d '{"apiKey": "sms_xxxxxxxxxxxxxxxx", "number": "9693521763"}'

Response Examples

Success (200 OK) 
{
  "success": true,
  "message": "SMS OTP dispatched successfully."
}
Error (400 Bad Request) 
{
  "success": false,
  "message": "Invalid API key or phone number."
}
POST /api/sms/verify-otp
ParameterTypeRequiredDescription
apiKeyStringYesYour SMS API key
numberStringYesRecipient's 10-digit mobile number
otpStringYes6-digit OTP code
cURL 
curl -X POST https://easyotpapi.online/api/sms/verify-otp \
  -H "Content-Type: application/json" \
  -d '{"apiKey": "sms_xxxxxxxxxxxxxxxx", "number": "9693521763", "otp": "194038"}'

Response Examples

Success (200 OK) 
{
  "success": true,
  "message": "OTP Verified successfully."
}
Error - Invalid OTP (400) 
{
  "success": false,
  "message": "Invalid OTP code."
}
Error - Expired (400) 
{
  "success": false,
  "message": "OTP expired or session not found."
}