
API — это протокол взаимодействия между вашим ПО и нашим сервером активаций. API нужен для автоматизации процесса получение смс сообщений на вашей стороне
Наше API совместимо с API sms-activate
Во всех запросах должен присутствовать API ключ в виде параметра api_key

&action=getNumber
$api_key — ваш API-ключ (см. раздел Настройки в Личном кабинете);
$service — код сервиса. См. раздел «Коды сервисов»;
$country — код страны. См. раздел «Коды стран». Вы можете передать "any" или оставить значение пустым, чтобы система автоматически выбрала лучшую доступную страну на основе наличия, цены и доставляемости;
$maxPrice — максимальная цена, за которую вы готовы купить номер;
$providerIds - список провайдеров, у которых будет осуществляться закупка, через запятую (1,2,3);
$exceptProviderIds - cписок провайдеров, у которых не будет осуществляться закупка, через запятую (1,2,3).
Возможные ошибки
BAD_KEY — неверный API-ключ;
NO_NUMBERS — нет номеров;
The service is prohibited for sale by administration — выберите другой сервис;
SERVICE_UNAVAILABLE_REGION — доступ из вашего региона ограничен, используйте другой IP.
Пример успешного ответа:
Где 38496653 — это id активации, а 66846426435 — номер телефона
&action=getNumberV2
Метод работает аналогично методу getNumber, принимает те же параметры, но возвращает дополнительную информацию об активации.
$api_key — ваш API-ключ (см. раздел Настройки в Личном кабинете);
$service — код сервиса. См. раздел «Коды сервисов»;
$country — код страны. См. раздел «Коды стран». Вы можете передать "any" или оставить значение пустым, чтобы система автоматически выбрала лучшую доступную страну на основе наличия, цены и доставляемости;
$maxPrice — максимальная цена, за которую вы готовы купить номер;
$providerIds - список провайдеров, у которых будет осуществляться закупка, через запятую (1,2,3);
$exceptProviderIds - cписок провайдеров, у которых не будет осуществляться закупка, через запятую (1,2,3).
Возможные ошибки
BAD_KEY — неверный API-ключ;
NO_NUMBERS — нет номеров;
The service is prohibited for sale by administration — выберите другой сервис;
SERVICE_UNAVAILABLE_REGION — доступ из вашего региона ограничен, используйте другой IP.
Пример успешного ответа:
{
"activationId": 38496653,
"phoneNumber": "66846426435",
"activationCost": 12.34,
"currency": 840,
"countryCode": "2",
"canGetAnotherSms": "1",
"activationTime": "2025-12-31 23:30:55"
}
Где 38496653 — это id активации, 66846426435 — номер телефона,
12.34 - стоимость активации,
870 - код валюты по ISO 4217, 2 - код страны,
0/1 - поддержка второй SMS (нет/да)
2025-12-31 23:30:55 - дата и время начала активации.
https://api.grizzlysms.com/stubs/handler_api.php?api_key=$api_key&action=setStatus&status=$status&id=$id
&action=setStatus
$api_key — ваш API-ключ (см. раздел Настройки в Личном кабинете)
$id — id активации
$status — статус активации
-1 — отменить активацию;
1 — сообщить о готовности номера (смс на номер отправлено);
3 — сообщить об ожидании нового кода на тот же номер;
6 — завершить активацию;
8 — отменить активацию.
Возможные ответы:
ACCESS_READY — готовность номера подтверждена
ACCESS_RETRY_GET — ожидание нового смс
ACCESS_ACTIVATION — сервис успешно активирован
ACCESS_CANCEL — активация отменена
Возможные ошибки:
ERROR_SQL — ошибка SQL-сервера;
NO_ACTIVATION — id активации не существует;
BAD_SERVICE — некорректное наименование сервиса;
BAD_STATUS — некорректный статус;
BAD_KEY — Неверный API-ключ;
BAD_ACTION — некорректное действие;
SERVICE_UNAVAILABLE_REGION — доступ из вашего региона ограничен, используйте другой IP.
https://api.grizzlysms.com/stubs/handler_api.php?api_key=$api_key&action=getStatus&id=$id
&action = getStatus
$api_key — ваш API-ключ (см. раздел Настройки в Личном кабинете)
$id — id активации
Ответы сервиса:
STATUS_WAIT_CODE — ожидание смс
STATUS_WAIT_RETRY:$lastcode — ожидание уточнения кода (где $lastcode - прошлый, неподошедший код)
STATUS_WAIT_RESEND — ожидание повторной отправки смс (софт должен нажать повторно выслать смс и выполнить изменение статуса на 6)
STATUS_CANCEL — активация отменена
STATUS_OK:$code — код получен (где $code — код активации)
Возможные ошибки:
NO_ACTIVATION — id активации не существует;
BAD_KEY — Неверный API-ключ;
BAD_ACTION — некорректное действие;
SERVICE_UNAVAILABLE_REGION — доступ из вашего региона ограничен, используйте другой IP.
https://api.grizzlysms.com/stubs/handler_api.php?api_key=$api_key&action=getStatusV2&id=$id
&action = getStatusV2
$api_key — ваш API-ключ (см. раздел Настройки в Личном кабинете)
$id — идентификатор активации
Ответы сервиса:
NO_ACTIVATION — идентификатор активации не существует
BAD_KEY — неверный API-ключ
BAD_ACTION — неверное действие
SERVICE_UNAVAILABLE_REGION — доступ из вашего региона ограничен, пожалуйста, используйте другой IP-адрес
Пример успешного ответа:
{
"verificationType": 2,
"sms": {
"dateTime": "2026-02-26 12:05:55",
"code": "852508",
"text": "852508"
}
}
Где dateTime — дата и время активации, code — SMS-код, text — полный текст SMS.
&action=getBalance
$api_key — ваш API-ключ (см. раздел Настройки в Личном кабинете).
Ответ сервиса
Возможные ошибки
&action=getPrices
$api_key — ваш API-ключ (см. раздел Настройки в Личном кабинете);
$service — код сервиса. См. раздел «Коды сервисов»;
$country — код страны. См. раздел «Коды стран».
Возможные ошибки
Ответы сервиса в формате
{
"Страна": {
"Сервис": {
"cost": Стоимость,
"count": Количество
}
}
}
&action=getPricesV2
$api_key — ваш API ключ (Настройки);
$service — код сервиса. См. раздел «Коды сервисов»;
$country — код страны. См. раздел «Коды стран».
Возможные ошибки
BAD_KEY — неверный API-ключ;
BAD_ACTION — некорректное действие;
BAD_SERVICE — некорректное наименование сервиса.
Ответы сервиса в формате
"country": {
"service": {
"price1": count,
"price2": count,
"price3": count,
}
},
&action=getPricesV3
$api_key — ваш API-ключ (см. раздел Настройки в Личном кабинете);
$service — код сервиса. См. раздел «Коды сервисов»;
$country — код страны. См. раздел «Коды стран».
Возможные ошибки
BAD_KEY — неверный API-ключ;
BAD_ACTION — некорректное действие;
BAD_SERVICE — некорректное наименование сервиса.
Ответы сервиса в формате
{
"country": {
"service": {
"price": price,
"count": count,
"providers": {
"provider 1 id": {
"count": count,
"price": [price1, price2],
"provider_id": provider_id
},
"provider 2 id": {
"count": count,
"price": [price],
"provider_id": provider_id
},
"provider 3 id": {
"count": count,
"price": [price1, price2, price3],
"provider_id": provider_id
}
}
}
}
}
$api_key – ваш ключ API (Настройки);
Пример ответа:
$api_key – ваш ключ API (Настройки);
Пример ответа:
{
{
"id": 22
"rus": "India"
"eng": "India"
"chn": "India"
}
}
$api_key – ваш ключ API (Настройки);
$coin – криптовалюта (usdt);
$network – сеть (trс-20)
Важно: средства зачисляются на ваш баланс автоматически при сумме от 50 USD.
Пример ответа: