# VirtualSMS Docs

## Docs

- [Get Balance](https://virtualsms.io/docs/api-reference/balance.md): Returns your current USD balance.
- [Buy Number](https://virtualsms.io/docs/api-reference/buy-number.md): Purchase an SMS verification number. Balance is deducted immediately.
- [Cancel Order](https://virtualsms.io/docs/api-reference/cancel-order.md): Cancel a pending order and receive a full refund.
- [List Countries](https://virtualsms.io/docs/api-reference/countries.md): Returns countries where numbers are available. - **Without `service` filter:** Returns all countries with available numbers, including which services are available per country. - **With `service` filter:** Returns countries for that specific service with exact pricing.
- [Get SMS Code](https://virtualsms.io/docs/api-reference/get-sms.md): Get the current status of an order. Poll every 3-5 seconds until SMS arrives, or use WebSocket for real-time delivery.
- [API Introduction](https://virtualsms.io/docs/api-reference/introduction.md): VirtualSMS REST API reference with interactive playground.
- [Legacy API (sms-activate)](https://virtualsms.io/docs/api-reference/legacy.md): Drop-in replacement for DaisySMS and sms-activate.
- [Price Lookup](https://virtualsms.io/docs/api-reference/price.md): Public endpoint for service / country pricing — no authentication required.
- [Get Profile](https://virtualsms.io/docs/api-reference/profile.md): Returns the authenticated account's profile — totals, API key count, telegram link.
- [List Services](https://virtualsms.io/docs/api-reference/services.md): Returns all SMS verification services available for purchase. By default, only services with **physical SIM card** numbers are returned. Add `include_voip=true` to also include VoIP-backed numbers.
- [Swap Number](https://virtualsms.io/docs/api-reference/swap.md): Get a replacement number for an active order if the original isn't receiving SMS.
- [Transactions](https://virtualsms.io/docs/api-reference/transactions.md): Paginated history of deposits, charges, refunds, and credits.
- [Authentication](https://virtualsms.io/docs/authentication.md): How to authenticate API requests.
- [Migrate from DaisySMS](https://virtualsms.io/docs/guides/daisy-migration.md): DaisySMS is shutting down March 26. Switch to VirtualSMS in 30 seconds.
- [MCP Server (AI Agents)](https://virtualsms.io/docs/guides/mcp-server.md): Use VirtualSMS with Claude, Cursor, Windsurf, and any MCP-compatible AI agent.
- [Referral Program](https://virtualsms.io/docs/guides/referral.md): Earn 15% commission on every purchase your referrals make.
- [Webhooks](https://virtualsms.io/docs/guides/webhooks.md): Get real-time notifications when SMS arrives or order status changes.
- [x402 — Stablecoin top-up for AI agents](https://virtualsms.io/docs/guides/x402.md): Top up a VirtualSMS balance with USDC/USDT in a single x402 payment, then run unlimited SMS verifications at retail prices. No signup form, no card, no manual API-key issuance.
- [VirtualSMS Documentation](https://virtualsms.io/docs/index.md): Buy virtual phone numbers and receive SMS verification codes for 2500+ services across 145+ countries.
- [Quickstart](https://virtualsms.io/docs/quickstart.md): Get your first virtual phone number in under 2 minutes.

## OpenAPI Specs

- [openapi](https://virtualsms.io/docs/openapi.yaml)

## Optional

- [Telegram Bot](https://t.me/VirtualSMSioBot)
- [Dashboard](https://virtualsms.io/dashboard)
- [MCP Server](https://smithery.ai/server/virtualsms/virtualsms-mcp)