Mulai

Referensi API Bulk SMS

BulkSMSAPI adalah API SMS massal untuk pengembang: kirim satu teks atau batch hingga 10.000 nomor per permintaan ke 227 negara melalui REST, lacak setiap pesan dengan webhook yang ditandatangani, dan bayar per pesan dari saldo prabayar. Referensi ini mencakup setiap endpoint, bidang, acara, dan kesalahan yang dimiliki API. Setiap halaman juga tersedia sebagai Markdown: tambahkan .md ke alamatnya.

URL dasar dan format

Semua permintaan dikirim ke https://bulksmsapi.cc/v1 melalui HTTPS. Badan permintaan adalah JSON (Content-Type: application/json, UTF-8), dan setiap jawaban adalah JSON, termasuk kesalahan. Waktu dalam format ISO 8601 di UTC. Uang adalah string dalam dolar AS dengan lima desimal ("0.00507"), sehingga harga di bawah satu sen tepat.

Endpoint

Metode dan jalurApa yang dilakukannyaKey
POST /v1/messagesKirim satu teks ke satu nomorYes
POST /v1/batchesKirim ke hingga 10.000 nomor, satu teks atau satu teks per nomorYes
GET /v1/messages/{id}Satu pesan dengan status dan harganyaYes
GET /v1/messagesPesan, terbaru dulu, filter berdasarkan batch atau statusYes
GET /v1/batches/{id}Satu batch dengan jumlah per statusYes
GET /v1/batchesBatch, terbaru duluYes
POST /v1/batches/{id}/cancelBatalkan batch terjadwal, pengembalian dana penuhYes
POST /v1/estimatesHitung harga permintaan tanpa mengirimkannyaYes
GET /v1/balanceSaldo dalam USDYes
GET /v1/pricingHarga per segmen untuk setiap negaraNo
GET /v1/pricing/{country}Harga untuk satu negara (kode ISO)No

Permintaan pertama

Buat kunci API di konsol, ekspor, dan kirim pesan. Jawabannya adalah 202 dengan objek pesan: biaya diambil dari saldo dan pesan dimasukkan ke antrian.

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
}

Bagaimana pesan bergerak

Pesan yang diterima akan queued (atau scheduled jika permintaan memiliki send_at). Antrian menyerahkannya ke jaringan setiap dua detik, hingga 1.200 per menit per akun, dan mereka menjadi sent. Status akhir adalah delivered atau failed; pesan yang gagal akan dikembalikan ke saldo segera. Setiap status akhir memanggil webhook Anda dengan acara yang ditandatangani.

Batas sekilas

BatasNilai
Penerima per permintaan API10,000
Penerima per kampanye konsol50,000
Permintaan per menit per kunci600
Pesan yang diserahkan ke jaringan per menit per akun1,200
Teks terpanjang10 segmen (1.530 karakter GSM-7 atau 670 karakter UCS-2)
Jadwal jendela2 menit hingga 45 hari ke depan
Percobaan webhook per acara10
Memori Idempotency-Key24 jam
Kunci API per akun10

File yang dapat dibaca mesin

Referensi API Bulk SMS | BulkSMSAPI Docs