Instant Delivery
Get virtual numbers instantly via API. Average response time under 500ms.
Secure Authentication
API key based authentication with optional IP whitelisting.
RESTful Design
Clean REST API with JSON responses. Easy to integrate with any language.
Webhook Support
Receive OTP notifications via webhooks in real-time.
Authentication
All API requests require authentication using your API key in the Authorization header:
Authorization: Bearer YOUR_API_KEYGet your API key from the dashboard after registration.
API Endpoints
GET
/api/v1/servicesList all available services and their pricesGET
/api/v1/countriesList all available countriesPOST
/api/v1/number/buyPurchase a virtual number for a specific serviceGET
/api/v1/number/{id}/smsCheck for received SMS/OTP on a numberPOST
/api/v1/number/{id}/cancelCancel a number and get refund (if no OTP received)GET
/api/v1/balanceCheck your account balanceQuick Start Example
JavaScript / Node.js
// Example: Get a virtual number for WhatsApp
const response = await fetch('https://api.uotp.store/v1/number/buy', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
service: 'whatsapp',
country: 'india'
})
});
const data = await response.json();
console.log(data);
// {
// "success": true,
// "number": "+91XXXXXXXXXX",
// "id": "abc123",
// "expires_at": "2024-01-15T10:20:00Z",
// "price": 5
// }Webhook Notifications
Configure a webhook URL in your dashboard to receive real-time notifications when an OTP is received.
Webhook Payload
// Webhook payload when OTP is received
{
"event": "otp_received",
"number_id": "abc123",
"number": "+91XXXXXXXXXX",
"service": "whatsapp",
"message": "Your WhatsApp code is 123456",
"otp": "123456",
"received_at": "2024-01-15T10:05:30Z"
}Rate Limits
100
Requests/minute
1000
Requests/hour
10000
Requests/day
Need higher limits? Contact us for enterprise plans with custom rate limits.