TODAY SMS

JSON · HTTPS · Kunci Bearer

Terima kode verifikasi dan kirim SMS dengan satu API SMS

API TODAY SMS adalah API untuk developer yang menggabungkan API verifikasi SMS untuk terima kode di nomor sekali pakai dan API kirim SMS ke 227 negara, dengan satu kunci API dan satu saldo. Semua permintaan dan respons berupa JSON, dan aturan harga serta refund sama dengan di situs web.

Lihat dokumentasi APIDaftar dan dapatkan kunci
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" }
  ]
}
  • 300 permintaan per menit
  • Satu kunci untuk terima dan kirim
  • Gagal atau tidak diterima, dikembalikan ke saldo
  • Isi saldo dengan 12 metode kripto

Yang bisa dilakukan dengan API SMS

API verifikasi SMS

Pilih aplikasi dan negara, beli nomor, lalu cek statusnya berkala untuk mendapat kode verifikasi. Jika SMS tidak masuk, seluruh dana kembali ke saldo saat waktu habis.

API kirim SMS

Kirim pesan Anda ke hingga 1.000 penerima sekaligus dan terima laporan pengiriman untuk tiap penerima. Tambahkan waktu terjadwal untuk mengirimnya nanti.

API harga dan stok

Ambil negara dan harga per aplikasi, jumlah nomor, dan harga per SMS tiap negara lewat API, lalu tampilkan apa adanya di layanan Anda sendiri.

Satu saldo

Terima dan kirim memakai saldo yang sama. Isi dengan USDT dan cek kapan saja lewat API.

Ringkasan metode

MetodeFungsi
GET/balanceCek saldo
GET/appsDaftar aplikasi
GET/prices?app=telegramNegara dan harga untuk satu aplikasi
POST/numbersBeli nomor
GET/numbers/{id}Status nomor dan SMS
POST/numbers/{id}/cancelBatalkan nomor
POST/numbers/{id}/finishSelesaikan nomor
GET/messages/pricesHarga SMS per negara
POST/messagesKirim SMS
GET/messages/{id}Status kirim dan laporan pengiriman
POST/messages/{id}/cancelBatalkan kiriman terjadwal

Apa itu API SMS?

API SMS adalah koneksi yang membuat software Anda bisa menerima atau mengirim SMS dengan permintaan HTTP. Kode melakukan apa yang biasanya diklik orang di layar web, jadi tugas berulang seperti tes pendaftaran otomatis, kirim kode verifikasi, dan notifikasi pesanan berjalan tanpa campur tangan siapa pun.

API TODAY SMS menawarkan dua hal sekaligus. Pertama, API verifikasi SMS (API aktivasi SMS) untuk terima kode verifikasi aplikasi di nomor sekali pakai, dan kedua, API kirim SMS untuk mengirim SMS ke ponsel di seluruh dunia. Keduanya memakai URL, kunci API, dan saldo yang sama, jadi tidak perlu daftar atau isi saldo terpisah.

Bagaimana cara memakai API verifikasi SMS?

Hanya empat langkah. Pilih kode aplikasi dengan GET /apps dan lihat negara serta harga dengan GET /prices?app=CODE. Beli nomor dengan POST /numbers untuk mendapat nomor dan id-nya, lalu panggil GET /numbers/{id} setiap beberapa detik untuk mengecek apakah kode sudah masuk. Setelah kode didapat, tutup nomor dengan POST /numbers/{id}/finish.

Tiap nomor menunggu SMS selama 20 menit, dan SMS ke nomor yang sama dalam waktu itu tanpa biaya tambahan. Jika SMS tidak masuk, seluruh dana kembali ke saldo saat waktu habis, dan jika belum ada yang masuk Anda bisa membatalkan sendiri dengan POST /numbers/{id}/cancel mulai 120 detik setelah pembelian. Untuk otomatisasi verifikasi aplikasi atau API nomor virtual dalam jumlah besar, cukup ulangi alur ini.

Bagaimana cara memakai API kirim SMS?

Kirim daftar penerima (to) dan teks pesan (text) ke POST /messages, lalu Anda menerima id pesan, jumlah penerima, jumlah bagian, dan total biaya. Masukkan penerima dalam format internasional dengan + dan kode negara, maksimal 1.000 per permintaan. Untuk menjadwalkan, isi at dengan waktu UTC.

Setelah mengirim, cek laporan pengiriman tiap penerima dengan GET /messages/{id}. Ada empat status: pending, sent, delivered, dan failed, dan dana untuk bagian yang berakhir failed ditambahkan ke refunded dan dikembalikan ke saldo Anda. Batalkan kiriman terjadwal yang belum terkirim dengan POST /messages/{id}/cancel.

Pakai metode yang sama untuk kirim kode verifikasi (OTP). Tiap kode dihitung satu SMS tanpa biaya verifikasi terpisah, dan Anda bisa mengambil harga per SMS tiap negara dengan GET /messages/prices untuk menghitung biaya.

Apa yang perlu diperhatikan dalam API SMS yang terjangkau?

Lihat total yang benar-benar Anda bayar, bukan hanya harga per SMS di daftar harga. TODAY SMS tidak memungut biaya bulanan dan hanya memotong bagian yang Anda kirim, dan bagian yang gagal serta kode verifikasi yang tidak pernah masuk dikembalikan ke saldo Anda.

Selanjutnya, lihat manajemen kunci dan batasan. Anda mendapatkan satu kunci API per akun dan dapat membuat yang baru kapan saja, yang akan memblokir kunci lama segera. Permintaan diizinkan hingga 300 per menit, cukup untuk sebagian besar otomatisasi. Terakhir, lihat pembayaran. Anda dapat mengisi saldo dengan 12 metode crypto termasuk USDT, USDC, dan BTC tanpa kartu, sehingga bisa langsung mulai dari negara mana pun.

Bagaimana cara mendapat kunci API?

Buat akun, dan setelah isi saldo pertama masuk Anda bisa membuat kunci di halaman kunci API. Kunci hanya ditampilkan sekali saat dibuat, jadi simpan di tempat yang aman. Kirim kunci itu di setiap permintaan lewat header Authorization: Bearer.

Jika Anda merasa kunci Anda bocor, buat kunci baru di halaman kunci API. Kunci lama langsung berhenti berfungsi. Siapa pun yang memegang kunci Anda bisa membeli nomor atau kirim SMS dengan saldo Anda, jadi jangan pernah menaruhnya di kode browser atau repositori publik.

Hubungkan API SMS hari ini

Daftar cukup dengan satu token. Setelah isi saldo pertama masuk, buat kunci API, tempel contoh dari dokumentasi, dan kirim permintaan pertama Anda.

Lihat dokumentasi APIDaftar dan dapatkan kunci