Добро пожаловать в SMS-Activation API.

API — это протокол взаимодействия между вашим ПО и нашими серверами; наш API совместим с популярными платформами. Все запросы отправляются на https://www.sms-activation.net/stubs/handler_api.php методами GET/POST; каждый запрос обязан содержать API-ключ в параметре api_key.

Общая информация (Overview)

Каждый запрос обязан содержать два общих параметра:

Если api_key недействителен или отсутствует, будет возвращён BAD_KEY,

если action не существует — BAD_ACTION.

Обзор Action

1. Проверка баланса getBalance

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

Параметры запроса

Пример запроса

curl "https://www.sms-activation.net/stubs/handler_api.php?api_key=YOUR_API_KEY&action=getBalance"

Пример ответа

ACCESS_BALANCE:128.50

Возможные ошибки

2. Получение цен getPrices

Возвращает цены и остатки номеров по странам/сервисам; возможна фильтрация по service и country.

Параметры запроса

Пример запроса

curl "https://www.sms-activation.net/stubs/handler_api.php?api_key=YOUR_API_KEY&action=getPrices&service=tg&country=187"

Пример ответа

{
  "187": {
    "tg": {
      "cost": 13.5,
      "count": 5000,
      "physicalCount": 4800
    }
  }
}

Структура ответа: { код_страны: { код_сервиса: { cost, count, physicalCount } } }:

3. Получение номера getNumber

Покупает временный номер для приёма SMS с кодом от заданного сервиса.

Параметры запроса

Пример запроса

curl "https://www.sms-activation.net/stubs/handler_api.php?api_key=YOUR_API_KEY&action=getNumber&service=tg&country=187"

Пример ответа

ACCESS_NUMBER:38223344:12015550123

Формат ответа — ACCESS_NUMBER:{activationId}:{phoneNumber}; сохраните activationId — он понадобится для последующих запросов и смены статуса.

Возможные ошибки

4. Обновление статуса активации setStatus

Вызывается после получения номера и сообщает системе о следующем шаге: повторная отправка SMS, подтверждение завершения или отмена активации.

Параметры запроса

Значения статусов

status=1 (номер готов) устанавливается системой автоматически — после getNumber передавать его вручную не нужно и нельзя.

Пример запроса

curl "https://www.sms-activation.net/stubs/handler_api.php?api_key=YOUR_API_KEY&action=setStatus&id=38223344&status=6"

Пример ответа

ACCESS_ACTIVATION

Возможные ошибки

5. Запрос активных активаций getActiveActivations

Возвращает все незавершённые (не подтверждённые и не отменённые) активации текущего аккаунта.

Параметры запроса

Пример запроса

curl "https://www.sms-activation.net/stubs/handler_api.php?api_key=YOUR_API_KEY&action=getActiveActivations"

Пример ответа

[
  {
    "activationId": "38223344",
    "phoneNumber": "12015550123",
    "countryCode": 187,
    "countryName": "United States",
    "countryNameCN": "美国",
    "serviceCode": "tg",
    "serviceNameCN": "Telegram",
    "activationStatus": 2,
    "status": 0,
    "activationCost": 13.5,
    "price_cn": 13.5,
    "activationTime": "2026-06-27T08:00:00.000Z",
    "canGetAnotherSms": true,
    "activationOperator": "",
    "discount": "",
    "repeated": "",
    "smsCode": ["123456"],
    "smsText": ["Your Telegram code: 123456"]
  }
]

Описание полей

Коды ошибок (Error Codes)