Выберите язык

API для разработчиков

SMS-верификация прямо из вашего кода

Один HTTPS-вызов даёт вашему боту или платформе настоящий номер для WhatsApp, Telegram и многих других сервисов. Получайте код через вебхук или long polling и платите только за номера, на которые он пришёл.

  • 2 281сервисов
  • 200стран
  • Автовозврат, если код не пришёл

curl

curl -s -X POST https://smsgrab.com/api/dev/v1/activations \
  -H "Authorization: Bearer $SMSGRAB_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"service":"whatsapp","country":"indonesia"}'

Python

activation = requests.post(
    "https://smsgrab.com/api/dev/v1/activations",
    headers={"Authorization": f"Bearer {key}", "Idempotency-Key": str(uuid.uuid4())},
    json={"service": "whatsapp", "country": "indonesia"},
    timeout=30,
).json()

Node.js

const activation = await fetch('https://smsgrab.com/api/dev/v1/activations', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${key}`,
    'Content-Type': 'application/json',
    'Idempotency-Key': crypto.randomUUID(),
  },
  body: JSON.stringify({ service: 'whatsapp', country: 'indonesia' }),
}).then((response) => response.json());

PHP

$activation = json_decode((string) $client->post('activations', [
    'json' => ['service' => 'whatsapp', 'country' => 'indonesia'],
    'headers' => ['Idempotency-Key' => bin2hex(random_bytes(16))],
])->getBody(), true);

Go

order := map[string]any{"service": "whatsapp", "country": "indonesia"}
err := call("POST", "/activations", order, idempotencyKey(), &activation)
201 Created
{
  "id": "5c1d0c2e-9f3a-4b7e-8a61-2f0c9d4e7b10",
  "compat_id": 100000123,
  "status": "WAITING_SMS",
  "service_id": "whatsapp",
  "country_id": "indonesia",
  "phone_number": "+6281234567890",
  "price_minor": 17,
  "currency": "USD",
  "expires_at": "2026-09-27T10:25:00.000Z",
  "sms": []
}

Создано для автоматизации

Всё, что нужно вашей интеграции, — с тем же запасом номеров, учётом и возвратами, что и в приложении.

  • Понятный REST API

    Предсказуемый JSON, идемпотентные покупки и ясные причины ошибок, на которые можно реагировать.

  • Подписанные вебхуки

    События с подписью HMAC для каждого кода и смены статуса, с повторами в течение 24 часов.

  • Long polling

    Держите запрос до 25 секунд и получайте код в момент его прихода.

  • Совместимость с sms-activate

    Направьте свои инструменты на новый адрес. Действия и ответы останутся прежними.

  • Ключи под вашим контролем

    Ключи только для чтения или для покупок, списки разрешённых IP, дневные лимиты, срок действия и замена без простоя.

  • Автоматические возвраты

    Код не пришёл до истечения номера? Деньги сразу вернутся на баланс.

  • Использование и журнал запросов

    Ежедневные запросы, расходы и ошибки по каждому ключу, а также журнал за последние 7 дней с фильтрами.

  • Цены за объём

    Те же цены, что в приложении, со скидками, которые автоматически растут вместе с месячным объёмом.

Запуск за четыре шага

До первого номера — всего несколько вызовов.

  1. Создайте аккаунт

    Зарегистрируйтесь по адресу электронной почты и подтвердите его. Приложение и сайт используют один аккаунт.

  2. Создайте API-ключ

    Выберите доступ, ограничьте ключ своими серверами и один раз скопируйте секрет.

  3. Купите номер

    Отправьте сервис и страну методом POST. Номер и цена придут сразу.

  4. Получите код

    Дождитесь его через long polling или вебхук, а затем завершите активацию.

Цены, которые снижаются по мере роста

API берёт те же цены, что и приложение. Ваша оптовая скидка растёт вместе с расходами за последние 30 дней во всех каналах.

  • Никогда не дороже того же номера в приложении
  • За номера без кода деньги возвращаются автоматически
  • Уровень обновляется через несколько минут после достижения
  • Списание в USD с того же баланса, что и в приложении

Скидка по расходам за 30 дней

Уровни объёма сейчас не действуют. Вы платите те же цены, что в приложении, а одобренные реселлеры получают свою фиксированную скидку.

Переход

Переходите с sms-activate одной строкой

Наш совместимый адрес работает по тому же протоколу, поэтому боты и панели для sms-activate заработают, как только вы смените базовый адрес и ключ.

SMS-Activate закрылся в декабре 2025 года. Направьте свои инструменты на SmsGrab, и они продолжат работать.

https://smsgrab.com/api/stubs/handler_api.php
  • getNumber, getStatus, setStatus, getPrices и все остальные стандартные действия
  • Числовые ID активаций, коды сервисов и ID стран, которые вы уже используете
  • Те же ключи, лимиты, цены, возвраты и вебхуки, что и в REST API
Справочник по совместимости

curl

BASE="https://smsgrab.com/api/stubs/handler_api.php?api_key=$SMSGRAB_API_KEY"

curl -s -w '\n' "$BASE&action=getBalance"
curl -s -w '\n' "$BASE&action=getNumber&service=tg&country=6&maxPrice=0.30"
curl -s -w '\n' "$BASE&action=getStatus&id=100000123"
curl -s -w '\n' "$BASE&action=setStatus&id=100000123&status=6"

Python

import os
import time

import requests

BASE = "https://smsgrab.com/api/stubs/handler_api.php"
KEY = os.environ["SMSGRAB_API_KEY"]


def action(name: str, **params) -> str:
    response = requests.get(BASE, params={"api_key": KEY, "action": name, **params}, timeout=30)
    response.raise_for_status()
    return response.text


print(action("getBalance"))
answer = action("getNumber", service="tg", country=6, maxPrice="0.30")
if not answer.startswith("ACCESS_NUMBER:"):
    raise SystemExit(answer)
_, activation_id, number = answer.split(":")
print("Number:", number)

while True:
    status = action("getStatus", id=activation_id)
    if status.startswith("STATUS_OK:"):
        print("Code:", status.split(":", 1)[1])
        action("setStatus", id=activation_id, status=6)
        break
    if status == "STATUS_CANCEL":
        print("Cancelled or expired, the charge was refunded")
        break
    time.sleep(5)

Node.js

const BASE = 'https://smsgrab.com/api/stubs/handler_api.php';

async function action(name, params = {}) {
  const url = new URL(BASE);
  url.search = new URLSearchParams({ api_key: process.env.SMSGRAB_API_KEY, action: name, ...params }).toString();
  const response = await fetch(url, { signal: AbortSignal.timeout(30_000) });
  if (!response.ok) {
    throw new Error(`HTTP ${response.status}: ${await response.text()}`);
  }
  return response.text();
}

console.log(await action('getBalance'));
const answer = await action('getNumber', { service: 'tg', country: '6', maxPrice: '0.30' });
if (!answer.startsWith('ACCESS_NUMBER:')) {
  throw new Error(answer);
}
const [, id, number] = answer.split(':');
console.log('Number:', number);

for (;;) {
  const status = await action('getStatus', { id });
  if (status.startsWith('STATUS_OK:')) {
    console.log('Code:', status.slice('STATUS_OK:'.length));
    await action('setStatus', { id, status: '6' });
    break;
  }
  if (status === 'STATUS_CANCEL') {
    console.log('Cancelled or expired, the charge was refunded');
    break;
  }
  await new Promise((resolve) => setTimeout(resolve, 5000));
}

PHP

<?php

function smsgrab(string $action, array $params = []): string
{
    $query = http_build_query(['api_key' => getenv('SMSGRAB_API_KEY'), 'action' => $action] + $params);
    $answer = file_get_contents('https://smsgrab.com/api/stubs/handler_api.php?'.$query, false, stream_context_create(['http' => ['timeout' => 30]]));
    if ($answer === false) {
        throw new RuntimeException('The request failed');
    }

    return $answer;
}

echo smsgrab('getBalance').PHP_EOL;
$answer = smsgrab('getNumber', ['service' => 'tg', 'country' => 6, 'maxPrice' => '0.30']);
if (! str_starts_with($answer, 'ACCESS_NUMBER:')) {
    exit($answer.PHP_EOL);
}
[, $id, $number] = explode(':', $answer);
echo 'Number: '.$number.PHP_EOL;

while (true) {
    $status = smsgrab('getStatus', ['id' => $id]);
    if (str_starts_with($status, 'STATUS_OK:')) {
        echo 'Code: '.substr($status, strlen('STATUS_OK:')).PHP_EOL;
        smsgrab('setStatus', ['id' => $id, 'status' => 6]);
        break;
    }
    if ($status === 'STATUS_CANCEL') {
        echo 'Cancelled or expired, the charge was refunded'.PHP_EOL;
        break;
    }
    sleep(5);
}

Go

package main

import (
	"fmt"
	"io"
	"net/http"
	"net/url"
	"os"
	"strings"
	"time"
)

const base = "https://smsgrab.com/api/stubs/handler_api.php"

var client = &http.Client{Timeout: 30 * time.Second}

func action(name string, params url.Values) (string, error) {
	query := url.Values{"api_key": {os.Getenv("SMSGRAB_API_KEY")}, "action": {name}}
	for key, values := range params {
		query[key] = values
	}
	response, err := client.Get(base + "?" + query.Encode())
	if err != nil {
		return "", err
	}
	defer response.Body.Close()
	body, err := io.ReadAll(io.LimitReader(response.Body, 1<<20))
	if err != nil {
		return "", err
	}
	if response.StatusCode != http.StatusOK {
		return "", fmt.Errorf("http %d: %s", response.StatusCode, body)
	}
	return string(body), nil
}

func main() {
	answer, err := action("getNumber", url.Values{"service": {"tg"}, "country": {"6"}, "maxPrice": {"0.30"}})
	if err != nil {
		panic(err)
	}
	if !strings.HasPrefix(answer, "ACCESS_NUMBER:") {
		fmt.Println(answer)
		return
	}
	parts := strings.Split(answer, ":")
	id := parts[1]
	fmt.Println("Number:", parts[2])
	for {
		status, err := action("getStatus", url.Values{"id": {id}})
		if err != nil {
			panic(err)
		}
		if code, ok := strings.CutPrefix(status, "STATUS_OK:"); ok {
			fmt.Println("Code:", code)
			if _, err := action("setStatus", url.Values{"id": {id}, "status": {"6"}}); err != nil {
				panic(err)
			}
			return
		}
		if status == "STATUS_CANCEL" {
			fmt.Println("Cancelled or expired, the charge was refunded")
			return
		}
		time.Sleep(5 * time.Second)
	}
}

В реальном времени

Коды приходят прямо на ваш сервер

Подпишитесь на нужные события, и мы доставим их на ваш HTTPS-адрес с подписью, которую можно проверить.

  • Номер куплен
  • Код получен
  • Активация завершена
  • Активация отменена
  • Активация истекла
  • Оплата возвращена
  • Баланс заканчивается
  • Пополнение создано
  • Пополнение подтверждается
  • Пополнение зачислено
  • Срок пополнения истёк
  • Пополнение на проверке
Руководство по вебхукам
600запросов в минуту на ключ
60покупок в минуту на ключ
100номеров в ожидании одновременно
25секунд long polling
  • Каждая доставка подписана HMAC-SHA256 с меткой времени
  • Только публичные HTTPS-адреса с проверкой перед каждой доставкой
  • Тестовые доставки, история за 30 дней и повторная доставка в один клик

Вопросы разработчиков

Сколько стоит API для разработчиков?

Подписки нет. Каждый номер стоит столько же, сколько в приложении, и оплачивается с того же баланса. Уровни объёма снижают эту цену по мере роста ваших расходов за 30 дней, а одобренные реселлеры получают фиксированную скидку. Номера без кода возвращаются автоматически.

Что будет, если код не придёт?

Номер действует до указанного вместе с ним времени окончания — обычно от 10 до 20 минут. Если за это время код не пришёл или вы отменили номер, пока он ещё ждёт, деньги автоматически вернутся на баланс.

Можно ли использовать мою интеграцию с sms-activate?

Да. Замените базовый адрес на наш совместимый и используйте ключ SmsGrab. Стандартные действия, ответы и числовые ID останутся прежними.

Какие лимиты частоты?

По умолчанию каждый ключ может делать 600 запросов и 60 покупок в минуту, все ключи аккаунта вместе — 3000 запросов в минуту, и одновременно код могут ждать до 100 номеров.

Как защитить ключ?

Храните ключи только на серверах, давайте каждому приложению свой ключ, ограничьте его адресами серверов и задайте дневной лимит расходов. Если ключ мог утечь, замените или отзовите его в аккаунте.

У приложения и API общий баланс?

Да. API использует баланс вашего аккаунта SmsGrab, а каждая покупка и возврат отображаются в кошельке, как и любые другие.

Больше ответов — в справочном центре

Готовы автоматизировать верификацию?

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