Начать

Справочник по Bulk SMS API

BulkSMSAPI, это API для массовой отправки SMS для разработчиков: отправляйте одно сообщение или пакет до 10 000 номеров за один запрос в 227 стран через REST, отслеживайте каждое сообщение с помощью подписанных вебхуков и оплачивайте каждое сообщение с предоплаченного баланса. Этот справочник охватывает все эндпоинты, поля, события и ошибки API. Каждая страница также доступна в формате Markdown: добавьте .md к её адресу.

Базовый URL и формат

Все запросы отправляются на https://bulksmsapi.cc/v1 через HTTPS. Тела запросов, это JSON (Content-Type: application/json, UTF-8), и каждый ответ, это JSON, включая ошибки. Время указывается в формате ISO 8601 в UTC. Деньги, это строка в долларах США с пятью знаками после запятой ("0.00507"), поэтому цены ниже цента точны.

Эндпоинты

Метод и путьЧто делаетKey
POST /v1/messagesОтправить одно сообщение на один номерYes
POST /v1/batchesОтправить до 10 000 номеров, одно сообщение или одно на каждый номерYes
GET /v1/messages/{id}Одно сообщение с его статусом и ценойYes
GET /v1/messagesСообщения, новые сверху, фильтр по пакету или статусуYes
GET /v1/batches/{id}Один пакет с количеством по статусамYes
GET /v1/batchesПакеты, новые сверхуYes
POST /v1/batches/{id}/cancelОтменить запланированный пакет, полный возврат средствYes
POST /v1/estimatesРассчитать стоимость запроса без отправкиYes
GET /v1/balanceБаланс в USDYes
GET /v1/pricingЦена за сегмент для каждой страныNo
GET /v1/pricing/{country}Цена для одной страны (код ISO)No

Первый запрос

Создайте API-ключ в консоли, экспортируйте его и отправьте сообщение. Ответ 202 с объектом сообщения: стоимость списывается с баланса, сообщение ставится в очередь.

curl https://bulksmsapi.cc/v1/messages \
  -H "Authorization: Bearer $BULKSMSAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+14155550123",
    "text": "Your Northwind code is 482913. It expires in 10 minutes.",
    "reference": "login-7781"
  }'
202 AcceptedJSON
{
  "id": "msg_8F3K2Q9TZ1MX",
  "object": "message",
  "batch_id": "bat_4M7Q1X0PK2RS",
  "to": "+14155550123",
  "country": "US",
  "text": "Your Northwind code is 482913. It expires in 10 minutes.",
  "segments": 1,
  "price": "0.00507",
  "currency": "USD",
  "status": "queued",
  "error": null,
  "reference": "login-7781",
  "created_at": "2026-11-07T09:30:12.418Z",
  "sent_at": null,
  "done_at": null
}

Как движется сообщение

Принятые сообщения получают статус queued (или scheduled, если указан send_at). Очередь передаёт их в сеть каждые две секунды, до 1200 в минуту на аккаунт, и они становятся sent. Финальный статус, delivered или failed; при неудаче средства сразу возвращаются на баланс. Каждый финальный статус вызывает ваш вебхук с подписанным событием.

Лимиты вкратце

ЛимитЗначение
Получателей на API-запрос10,000
Получателей на кампанию в консоли50,000
Запросов в минуту на ключ600
Сообщений в сеть в минуту на аккаунт1,200
Максимальная длина текста10 сегментов (1530 GSM-7 или 670 UCS-2 символов)
Окно планированияОт 2 минут до 45 дней вперёд
Попыток вебхука на событие10
Хранение Idempotency-Key24 часа
API-ключей на аккаунт10

Машиночитаемые файлы

Справочник по Bulk SMS API | Документация BulkSMSAPI