JSON · HTTPS · Bearer-ключ

Приймайте коди підтвердження й надсилайте SMS через один SMS API

API TODAY SMS це API для розробників, який поєднує API SMS-верифікації для прийому кодів на одноразові номери та API надсилання SMS у 227 країн з одним API-ключем і одним балансом. Усі запити й відповіді в JSON, а ціни та правила повернення такі самі, як на сайті.

Документація API Зареєструватися й отримати ключ

today-sms.com/api/v1

$ curl -X POST https://today-sms.com/api/v1/numbers \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"app":"telegram","country":"indonesia"}'
{
  "id": "N-7K2M-QX4P-9D3A",
  "phone": "+6281234567890",
  "price": "0.4515",
  "status": "waiting",
  "expires_at": "2026-10-18T09:20:00.000Z"
}

$ curl https://today-sms.com/api/v1/numbers/N-7K2M-QX4P-9D3A \
  -H "Authorization: Bearer YOUR_API_KEY"
{
  "id": "N-7K2M-QX4P-9D3A",
  "status": "received",
  "sms": [
    { "code": "482913", "text": "Your code is 482913", "at": "2026-10-18T09:02:11.000Z" }
  ]
}

$ curl -X POST https://today-sms.com/api/v1/messages \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"to":["+14155550100","+447700900123"],"text":"Your code is 482913"}'
{
  "id": "m_7Q2K9X",
  "status": "queued",
  "recipients": 2,
  "parts": 1,
  "encoding": "GSM-7",
  "cost": "0.0136"
}

$ curl https://today-sms.com/api/v1/messages/m_7Q2K9X \
  -H "Authorization: Bearer YOUR_API_KEY"

300 запитів за хвилину
Один ключ для прийому й надсилання
Повернення на баланс за недоставлене й неотримане
Поповнити 12 методами криптовалюти

Що можна робити з SMS API

API SMS-верифікації

Оберіть застосунок і країну, купіть номер і опитуйте його статус, щоб отримати код підтвердження. Якщо SMS не надійде, після закінчення терміну вся сума повернеться на баланс.

API надсилання SMS

Надсилайте повідомлення до 1,000 одержувачам за раз і отримуйте звіт про доставку за кожним. Вкажіть час, щоб запланувати надсилання.

API цін і наявності

Отримуйте через API країни й ціни за застосунками, кількість номерів і ціну за SMS для кожної країни та показуйте їх у своєму сервісі як є.

Один баланс

Прийом і надсилання використовують один баланс. Поповнюйте його в USDT і перевіряйте через API будь-коли.

Методи в одній таблиці

Повна документація

Метод	Що робить
GET/balance	Отримати баланс
GET/apps	Список застосунків
GET/prices?app=telegram	Країни й ціни для застосунку
POST/numbers	Купити номер
GET/numbers/{id}	Статус номера та SMS
POST/numbers/{id}/cancel	Скасувати номер
POST/numbers/{id}/finish	Завершити номер
GET/messages/prices	Ціни на SMS за країнами
POST/messages	Надіслати SMS
GET/messages/{id}	Статус надсилання та звіти про доставку
POST/messages/{id}/cancel	Скасувати заплановане надсилання

Що таке SMS API?

SMS API це підключення, через яке ваша програма приймає або надсилає SMS за допомогою HTTP-запитів. Код робить те, що людина зробила б кліками на сайті, тому повторювані завдання, як-от автотести реєстрації, надсилання кодів підтвердження та сповіщень про замовлення, виконуються без ручної роботи.

API TODAY SMS дає дві можливості разом. Перша це API SMS-верифікації (API SMS-активації) для прийому кодів підтвердження застосунків на одноразові номери, друга це API надсилання SMS на мобільні телефони в усьому світі. Обидва використовують один URL, один API-ключ і один баланс, тому окрема реєстрація й окреме поповнення не потрібні.

Як користуватися API SMS-верифікації?

Лише чотири кроки. Оберіть код застосунку через GET /apps і перегляньте країни й ціни через GET /prices?app=CODE. Купіть номер через POST /numbers і отримайте номер та його id, потім кожні кілька секунд викликайте GET /numbers/{id}, щоб перевірити, чи надійшов код. Отримавши код, закрийте номер через POST /numbers/{id}/finish.

Кожен номер чекає на SMS 20 хвилин, а SMS на той самий номер за цей час нічого не коштують. Якщо SMS не надійде, після закінчення терміну вся сума повернеться на баланс, а якщо нічого не надійшло, номер можна скасувати самостійно через POST /numbers/{id}/cancel, починаючи з 120 секунд після покупки. Коли потрібна автоматизація верифікації застосунків або API віртуальних номерів для великих обсягів, просто повторюйте цей сценарій.

Як користуватися API надсилання SMS?

Надішліть список одержувачів (to) і текст повідомлення (text) на POST /messages, і у відповідь надійдуть id повідомлення, кількість одержувачів, кількість частин і підсумкова вартість. Вказуйте одержувачів у міжнародному форматі з + і кодом країни, до 1,000 у запиті. Щоб запланувати надсилання, вкажіть час UTC в at.

Після надсилання перевіряйте звіт про доставку за кожним одержувачем через GET /messages/{id}. Статусів чотири: pending, sent, delivered і failed, а сума за частини зі статусом failed додається в refunded і повертається на баланс. Заплановане надсилання, яке ще не почалося, скасовуйте через POST /messages/{id}/cancel.

Тим самим методом надсилайте коди підтвердження (OTP). Кожен код рахується одним SMS без окремої плати за верифікацію, а ціну за SMS для кожної країни можна отримати через GET /messages/prices і розрахувати витрати.

На що зважати, обираючи недорогий SMS API?

Зважайте на підсумкову суму, яку ви реально платите, а не лише на ціну за SMS у прайс-листі. У TODAY SMS немає абонентської плати, списуються лише надіслані частини, а за недоставлені частини й коди підтвердження, які так і не надійшли, гроші повертаються на баланс.

Далі розгляньте управління ключами та обмеження. Ви отримуєте один API-ключ на обліковий запис і можете створити новий у будь-який час, що негайно блокує старий ключ. Дозволено до 300 запитів на хвилину, що достатньо для більшості автоматизацій. Нарешті, розгляньте оплату. Ви можете поповнити баланс за допомогою 12 криптовалютних методів, включаючи USDT, USDC і BTC без картки, що дозволяє почати відразу з будь-якої країни.

Як отримати API-ключ?

Створіть акаунт, і після зарахування першого поповнення ви зможете створити ключ на сторінці API-ключа. Ключ показується лише один раз під час створення, тому збережіть його в надійному місці. Передавайте його в кожному запиті в заголовку Authorization: Bearer.

Якщо ви вважаєте, що ключ витік, створіть новий на сторінці API-ключа. Старий ключ одразу перестане працювати. Будь-хто, у кого є ваш ключ, може купувати номери чи надсилати SMS з вашого балансу, тому ніколи не розміщуйте його в коді браузера чи публічному репозиторії.

Підключіть SMS API вже сьогодні

Для реєстрації потрібен лише один токен. Після зарахування першого поповнення створіть API-ключ, вставте приклад із документації й надішліть перший запит.