API Introduction

The VirtualSMS REST API is the single interface behind SMS verification. The same API also covers dedicated rentals and matching-country proxies: one API, one prepaid balance.

Base URL

https://virtualsms.io/api/v1

All requests require x-api-key header. Responses are JSON.

curl https://virtualsms.io/api/v1/customer/balance \
  -H "x-api-key: YOUR_API_KEY"

Each endpoint page below includes a built-in Try It panel on the right side. Enter your API key and test requests directly from the docs.

Full-featured with JSON responses, WebSocket support, and webhooks.

https://virtualsms.io/api/v1/

Drop-in replacement for DaisySMS. Same action names, response formats, and error codes.

https://virtualsms.io/stubs/handler_api.php

Success responses return JSON with the requested data. Error responses include:

{
  "error": "insufficient_balance",
  "message": "Balance too low for this order"
}