Перейти к содержимому
tomnumber

API для SMS-верификации

Покупайте номера и получайте коды из своей программы. API работает с вашим балансом, по тем же ценам и с тем же правилом возврата через 20 минут, что и сайт.

API-ключ создается в личном кабинете. Номера, купленные через API, оплачиваются с того же баланса и по тем же ценам, что и на сайте.

Создать аккаунтAPI-ключ

От $0.0018 за номер

Главное

Самая низкая цена за номер
$0.0018
Аутентификация
API-ключ
Формат
JSON по HTTPS
Лимит запросов
120 запросов в минуту
Возврат
Как на сайте

REST и JSON

Шесть запросов: баланс, сервисы, цены, получение номера, статус и отмена.

Ключ из личного кабинета

Создайте ключ на странице API-ключа в личном кабинете и передавайте его в заголовке Authorization.

Цены как на сайте

Цены на номера и правило возврата через 20 минут такие же, как на сайте.

Какие запросы можно отправлять?

Пути добавляются к базовому URL. Для каждого запроса нужен API-ключ.

Какие запросы можно отправлять?
Метод и путьЧто делает
GET/balanceВаш баланс в USD
GET/servicesВсе сервисы с самой низкой ценой и числом стран
GET/prices?service=telegramЦена одного номера для сервиса во всех странах
POST/numbersПолучить номер для сервиса и страны, цена списывается с баланса
GET/numbers/{id}Статус номера и все полученные на данный момент коды
POST/numbers/{id}/cancelОтмена до прихода кода, деньги возвращаются на баланс

В каком порядке вызывать API?

  1. 1

    Получите номер POST /numbers с service и country. Сохраните id и номер.

  2. 2

    Введите номер Введите номер в сервисе, который отправляет код.

  3. 3

    Проверяйте код GET /numbers/{id} каждые 5 секунд, пока список codes не станет непустым.

  4. 4

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

Как получить API-ключ?

Войдите и откройте в личном кабинете раздел API-ключ. Создайте ключ и сразу скопируйте его: он показывается только один раз. Новый ключ отключает старый.

API-ключ

Какой базовый URL?

Отправляйте все запросы на этот адрес, а ключ передавайте в заголовке Authorization (Bearer) или X-Api-Key:

https://tomnumber.com/api/v1
Authorization: Bearer <API_KEY>

Поля запроса

Поля запроса
ПолеГде используетсяЗначение
servicePOST /numbers, GET /pricesНазвание сервиса из /services, например telegram
countryPOST /numbersДвухбуквенный код страны, например gb

Поля ответа и статусы

Поля ответа и статусы
ЗначениеЧто означает
waitingНомер открыт, кода пока нет
receivedПришел хотя бы один код, до expires_at могут прийти еще
refundedЗа 20 минут кода не было, деньги вернулись на баланс
canceledВы отменили номер до прихода кода, деньги вернулись на баланс

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

{  "ok": true,  "id": "R8KQ2M7XWD4P",  "service": "telegram",  "country": "gb",  "number": "+44 7700 900412",  "price": "0.167",  "status": "received",  "expires_at": "2026-11-11T09:20:00.000Z",  "codes": [    { "code": "483920", "text": "Telegram code: 483920", "received_at": "2026-11-11T09:01:12.000Z" }  ]}

Коды ошибок

Коды ошибок
unauthorizedAPI-ключ не указан или неверный
rate_limitedБольше 120 запросов за минуту
bad_serviceНеизвестное название сервиса
bad_countryСтрана недоступна для этого сервиса
low_balanceНа балансе меньше, чем стоит номер
unavailableСвободных номеров сейчас нет. Деньги не списаны
not_foundВ вашем аккаунте нет номера с таким id
cannot_cancelКод уже пришел или номер закрыт

Примеры кода

# get a numbercurl -X POST https://tomnumber.com/api/v1/numbers \  -H "Authorization: Bearer $API_KEY" \  -H "Content-Type: application/json" \  -d '{"service":"telegram","country":"gb"}' # check for codescurl https://tomnumber.com/api/v1/numbers/R8KQ2M7XWD4P \  -H "Authorization: Bearer $API_KEY"

API для SMS-верификации: частые вопросы

Что такое API для SMS-верификации?

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

API стоит дополнительных денег?

Нет. Номера стоят столько же, сколько на сайте, и оплачиваются с того же баланса.

Сколько запросов можно отправлять?

До 120 запросов в минуту на один ключ. Опрос каждые 5 секунд укладывается в этот лимит с большим запасом.

Номера через API тоже возвращаются?

Да, по тому же правилу: если за 20 минут кода нет, деньги возвращаются на баланс.

Где создать ключ?

В личном кабинете, в разделе API-ключ.

Виртуальные номера для других сервисов