Welcome to VaraSMS

Virtual Number Made Easy

VaraSMS Developer Platform

Powerful REST API for Modern OTP Automation

Integrate SMS activations, OTP retrieval, balance management and transaction history using the premium VaraSMS API v2 infrastructure.

Secure Authentication Fast JSON Responses Easy Integration
API Response
{
  "status": "ok",
  "order_id": "45821",
  "number": "+2348123456789",
  "service": "WhatsApp",
  "otp": "483920",
  "cost": "120.00",
  "country": "Nigeria"
}
REST API v2
JSON Response
API Infrastructure

Choose the Right VaraSMS API

VaraSMS provides multiple API systems designed for developers, automation platforms and advanced integrations.

Legacy

Compatible API

Simple GET-based API compatible with SMS-Activate style integrations.

  • Easy migration support
  • Plain text responses
  • Lightweight integration
Recommended

REST API v2

Modern JSON REST API with advanced order management, transaction history and scalable automation.

  • JSON responses
  • Secure authentication
  • Transaction history endpoint
  • Advanced automation support
Coming Soon

Rent API

Long-term virtual number rentals for businesses and enterprise usage.

  • Rental number management
  • Long-term activations
  • Enterprise integrations
Developer Infrastructure

Built for Fast & Reliable Automation

Powerful API infrastructure designed for OTP platforms, automation systems and enterprise integrations.

Secure API Authentication

Authenticate requests using secure API keys with support for query parameters and request headers.

X-API-Key Secure Access

JSON & Compatible Responses

Use lightweight plain-text compatible responses or advanced JSON REST responses with API v2.

REST JSON SMS-Activate Compatible

Wallet & Transaction APIs

Access balance details, transaction history, order tracking and automated refund handling.

Balance API Auto Refund

OTP & Activation Management

Buy virtual numbers, poll OTP status, retry SMS and manage activation lifecycle.

OTP Polling Activation Control

Multi-Language Integration

Easy integration examples for PHP, JavaScript and Python applications.

PHP JS Python

High Performance API

Optimized infrastructure with scalable endpoints, fast response times and rate limit protection.

Fast Requests Rate Limited
Quick Integration

Start Using VaraSMS API v2

Integrate the VaraSMS REST API in minutes using secure authentication and JSON responses.

01

Generate API Key

Create your VaraSMS account and generate your secure API key from the dashboard.

Secure Access Dashboard API
02

Send API Request

Make GET or POST requests to buy numbers, check balances or retrieve OTP codes.

GET & POST REST API
03

Receive JSON Response

Parse structured JSON responses for balances, transactions and OTP statuses.

JSON Data Fast Responses
04

Handle OTP Orders

Poll activation status, retrieve OTP codes and manage number lifecycle automatically.

OTP Polling Activation API
05

Complete or Cancel

Finish successful activations or cancel unused orders with automatic refunds.

Auto Refund Order Control
REST API 2.0

Production Ready REST Endpoints

Full JSON-based API infrastructure for wallet management, OTP activations, transactions, order control and advanced automation.

GET Wallet

Balance API

/v1/?action=balance

Retrieve wallet balance, total deposits, total OTP usage and account currency.

Wallet JSON
GET Finance

Transactions API

/v1/?action=transactions

Fetch paginated transaction history, funding records and OTP order charges.

History Pagination
GET Countries

Countries API

/v1/?action=countries

Retrieve all supported countries, ISO codes and activation availability.

ISO Codes Availability
GET Services

Services API

/v1/?action=services

Retrieve available services, pricing, stock count and service codes.

Pricing Stock
POST Activation

Buy Number API

/v1/?action=buy

Purchase virtual numbers instantly for OTP verification and SMS activation.

OTP Virtual Numbers
GET Verification

Check OTP API

/v1/?action=check

Poll OTP delivery status and retrieve SMS verification codes in real time.

OTP Polling Realtime
POST Orders

Cancel API

/v1/?action=cancel

Cancel inactive activations with automatic wallet refund processing.

Refund Cancel Order
POST Completion

Finish API

/v1/?action=finish

Mark successful activations as completed after OTP verification is finished.

Complete Success
POST Reporting

Report Bad API

/v1/?action=ban

Report invalid or problematic numbers directly through the API infrastructure.

Bad Number Reporting
JSON Responses

Clean & Structured Responses

VaraSMS REST API returns modern JSON responses with standardized success and error handling.

Success Response

status: ok

Successful API requests return a clean JSON object containing response data and status confirmation.

{
  "status": "ok",
  "balance": 4500.00,
  "currency": "NGN",
  "total_otp": 42
}
JSON REST API Success

Error Response

status: error

Failed requests return detailed error messages to simplify debugging and request validation.

{
  "status": "error",
  "message": "Insufficient balance"
}
Validation Errors Debugging
200

Request Successful

API request completed successfully.

400

Invalid Request

Missing or invalid request parameters.

401

Unauthorized

Invalid or missing API key.

429

Rate Limited

Too many requests sent to the API.

502

Provider Error

Upstream provider service failed.

AUTO

Automatic Refund

Refund processed automatically on cancellation.

SDK Examples

Integrate with Your Favorite Language

Start integrating VaraSMS API instantly using ready-to-use code examples for popular languages.

PHP Example
<?php

$api_key = "YOUR_API_KEY";

$url = "https://api.varasms.com/v1/?action=balance&api_key=".$api_key;

$response = file_get_contents($url);

$data = json_decode($response, true);

print_r($data);

?>
JavaScript Example
const apiKey = "YOUR_API_KEY";

fetch(
"https://api.varasms.com/v1/?action=balance&api_key=" + apiKey
)
.then(res => res.json())
.then(data => {

    console.log(data);

});
Python Example
import requests

api_key = "YOUR_API_KEY"

url = f"https://api.varasms.com/v1/?action=balance&api_key={api_key}"

response = requests.get(url)

print(response.json())
cURL Example
curl --request GET \
"https://api.varasms.com/v1/?action=balance&api_key=YOUR_API_KEY"
Security & Stability

Secure & Reliable API Infrastructure

VaraSMS API is built with modern security practices, request protection and scalable infrastructure for stable integrations.

Secure API Authentication

Every request requires a valid API key to prevent unauthorized access and abuse.

API Keys Protected Access

HTTPS Encryption

All API traffic is encrypted using HTTPS to secure requests and sensitive data transmission.

SSL Encrypted Requests

Rate Limit Protection

Intelligent rate limiting helps protect infrastructure stability and provider performance.

Anti Abuse Request Limits

Stable Infrastructure

Optimized backend infrastructure ensures reliable uptime and fast response delivery.

High Uptime Fast API
API Guidelines

Recommended Request Limits

To maintain stable performance and avoid temporary restrictions, follow the recommended API request practices below.

1 - 2 Seconds Recommended OTP polling interval
Avoid Spam Requests Excessive requests may trigger temporary limits
Keep API Keys Private Never expose your API keys publicly
REST API v2
JSON Infrastructure
Start Building Today

Build Faster with VaraSMS API v2

Integrate OTP activations, wallet systems, transaction history and automated verification workflows using the modern VaraSMS REST API platform.

Secure Authentication REST JSON API Fast Responses Stable Infrastructure
Developer FAQ

Frequently Asked API Questions

Everything developers need to know about VaraSMS REST API integration and automation.

Login to your VaraSMS dashboard and navigate to the API section to generate your secure API key instantly.

Yes. VaraSMS API v2 returns structured JSON responses for balances, transactions, OTP status and activations.

Yes. You can cancel inactive orders using the cancel endpoint. Eligible activations are refunded automatically.

Yes. VaraSMS provides a compatible API layer for easier migration from SMS-Activate style systems.

VaraSMS API works with PHP, JavaScript, Python, cURL and any language capable of sending HTTP requests.