VirtualSMS
## VirtualSMS — real-SIM phone numbers for SMS verification VirtualSMS provides disposable and long-term phone numbers backed by **real SIM cards** across **145+ countries** and **2,500+ services** including WhatsApp, Telegram, Google, Discord, Facebook, Instagram, TikTok, Uber, and Airbnb. Buy a number, poll for the OTP code, cancel for a full refund inside the 120-second cooldown — all via…
VirtualSMS endpoints
| Method | Endpoint | Description |
|---|---|---|
| Numbers | ||
| GET |
listOrders /api/v1/customer/orders |
Returns a list of recent orders for the authenticated account. |
| POST |
buyNumber /api/v1/customer/purchase |
Purchases a phone number for the given service and country. Charges your account balance. |
| GET |
getOrderStatus /api/v1/customer/order/{orderId} |
Returns the current status of an order plus any received SMS messages in the `messages` array. |
| POST |
cancelOrder /api/v1/customer/cancel/{orderId} |
Cancels an order and refunds the balance. Returns HTTP 425 inside the 120-second cooldown after purchase. |
| Catalog | ||
| GET |
listCountries /api/v1/customer/countries |
Returns countries with their ISO codes, minimum prices, and the list of services available in each. |
| GET |
listServices /api/v1/customer/services |
Returns the full service catalog. Service IDs are short codes used as the `service` parameter in `/customer/purchase`. |
| Account | ||
| GET |
getBalance /api/v1/customer/balance |
Returns the current USD balance for the authenticated account. |
| Pricing | ||
| GET |
checkPrice /api/v1/price |
Unauthenticated price lookup. Returns the current price for a service/country combination and an availability indicator. Useful as a pre-flight check before calling… |
VirtualSMS pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| BASIC | Free | — |
|