HTTP & JSON API

VirtualSim API

API для автоматизации получения SMS на виртуальные номера. Все запросы возвращают JSON. Цены в USD.

Production ready 2 req/sec per API key 180+ стран, тысячи сервисов

Аутентификация

Во всех запросах должен присутствовать ваш персональный API-ключ. Получите его в профиле, включив API-доступ.

Способ 1 — Query-параметр (рекомендуется)

Передайте ключ в параметре api_key любого запроса.

https://virtualsim.io/api/v1/getBalance?api_key=YOUR_API_KEY

Способ 2 — HTTP-заголовок

Передайте ключ в заголовке Authorization с префиксом Bearer.

Authorization: Bearer YOUR_API_KEY

Оба способа равнозначны. При неверном ключе сервер вернёт 401 Unauthorized.

Лимиты запросов

Ограничение: 2 запроса в секунду на API-ключ. При превышении сервер вернёт 429 Too Many Requests.

API активации

POST Заказ номера

Покупает виртуальный номер для указанного сервиса и страны. Средства списываются с баланса.

https://virtualsim.io/api/v1/orderNumber

Параметр	Тип	Обяз.	Описание
service	string	да	Код сервиса (tg, wa, vk, ...)
country	number	да	ID страны из каталога

GET Получить статус активации

Возвращает текущий статус активации и полученный код SMS.

https://virtualsim.io/api/v1/getStatus?id=$id

Параметр	Тип	Обяз.	Описание
id	string	да	ID активации, полученный при заказе

POST Изменение статуса активации

Управляет жизненным циклом активации.

https://virtualsim.io/api/v1/setStatus

Параметр	Тип	Обяз.	Описание
id	string	да	ID активации
status	number	да	Код статуса (см. ниже)

Коды статусов:
1 — готовность номера; 3 — повторная SMS; 6 — завершить; 8 — отменить.

GET Все активные активации

Возвращает список всех текущих активаций пользователя.

https://virtualsim.io/api/v1/getActiveActivations

Каталог и баланс

GET Получить актуальные цены

Возвращает цены и количество доступных номеров.

https://virtualsim.io/api/v1/getPrices?service=$service&country=$country

Параметр	Тип	Обяз.	Описание
service	string	нет	Код сервиса для фильтрации
country	number	нет	ID страны для фильтрации

GET Список стран

https://virtualsim.io/api/v1/getCountries

GET Список сервисов

https://virtualsim.io/api/v1/getServices

GET Проверка баланса

https://virtualsim.io/api/v1/getBalance

POST SMS Webhook

Настройте URL для получения webhook при получении SMS.

https://virtualsim.io/api/v1/setSmsWebhook

Параметр	Тип	Обяз.	Описание
enabled	boolean	да	Включить / выключить webhook
url	string	нет	URL обработчика (обязателен при enabled=true)
secret	string	нет	Signing secret для X-Signature

{\n  "event": "sms.received",\n  "activationId": "123456",\n  "service": "tg",\n  "country": 2,\n  "phoneNumber": "79990001122",\n  "text": "Sms text",\n  "code": "12345",\n  "receivedAt": "2026-03-17 12:00:00 UTC"\n}

python_example.py

import requests

API = "https://virtualsim.io/api/v1"
KEY = "YOUR_API_KEY"

prices = requests.get(
  f"{API}/getPrices",
  params={"service": "tg", "api_key": KEY}
).json()

order = requests.post(
  f"{API}/orderNumber",
  params={"api_key": KEY},
  json={"service": "tg", "country": 0}
).json()

status = requests.get(
  f"{API}/getStatus",
  params={"id": order["activationId"],
          "api_key": KEY}
).json()

H = {"Authorization": f"Bearer {KEY}"}
balance = requests.get(
  f"{API}/getBalance", headers=H
).json()
# {"balance": 10.00, "currency": "USD"}

getPrices response

{
  "0": {
    "tg": { "cost": 0.42, "count": 11540 },
    "wa": { "cost": 0.18, "count": 8230 },
    "vk": { "cost": 0.12, "count": 5700 }
  },
  "6": { "tg": { "cost": 0.21, "count": 4500 } }
}

orderNumber response

{
  "activationId": 38496653,
  "phoneNumber": "79001234567",
  "cost": 0.42,
  "currency": "USD",
  "balance": 9.58
}

getActiveActivations response

{
  "activations": [{
    "activationId": "38496653",
    "service": "tg",
    "country": 0,
    "phoneNumber": "79001234567",
    "cost": 0.42,
    "smsReceived": true,
    "messages": [{
      "text": "Code: 12345",
      "receivedAt": "2026-03-09 14:30:00"
    }]
  }]
}