Inizia

Riferimento API Bulk SMS

BulkSMSAPI è un'API SMS per sviluppatori: invia un testo o un batch fino a 10.000 numeri per richiesta in 227 paesi via REST, monitora ogni messaggio con webhook firmati e paga a messaggio da un saldo prepagato. Questo riferimento copre ogni endpoint, campo, evento ed errore dell'API. Ogni pagina è disponibile anche come Markdown: aggiungi .md al suo indirizzo.

URL base e formato

Tutte le richieste vanno a https://bulksmsapi.cc/v1 via HTTPS. I corpi sono JSON (Content-Type: application/json, UTF-8) e ogni risposta è JSON, inclusi gli errori. Gli orari sono ISO 8601 in UTC. Il denaro è una stringa in dollari USA con cinque decimali ("0.00507"), quindi i prezzi sotto un centesimo sono esatti.

Endpoint

Metodo e percorsoCosa faKey
POST /v1/messagesInvia un testo a un numeroYes
POST /v1/batchesInvia fino a 10.000 numeri, un testo o uno per numeroYes
GET /v1/messages/{id}Un messaggio con il suo stato e prezzoYes
GET /v1/messagesMessaggi, i più recenti per primi, filtra per batch o statoYes
GET /v1/batches/{id}Un batch con conteggi per statoYes
GET /v1/batchesBatch, i più recenti per primiYes
POST /v1/batches/{id}/cancelAnnulla un batch programmato, rimborso completoYes
POST /v1/estimatesPreventiva una richiesta senza inviarlaYes
GET /v1/balanceSaldo in USDYes
GET /v1/pricingPrezzo per segmento per ogni paeseNo
GET /v1/pricing/{country}Prezzo per un paese (codice ISO)No

Una prima richiesta

Crea una chiave API nella console, esportala e invia un messaggio. La risposta è 202 con l'oggetto messaggio: il costo viene prelevato dal saldo e il messaggio viene accodato.

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
}

Come si muove un messaggio

I messaggi accettati vengono accodati (queued) o programmati (scheduled se la richiesta ha send_at). La coda li passa alla rete ogni due secondi, fino a 1.200 al minuto per account, e diventano sent. Lo stato finale è delivered o failed; un messaggio fallito viene rimborsato immediatamente sul saldo. Ogni stato finale attiva il tuo webhook con un evento firmato.

Limiti a colpo d'occhio

LimiteValore
Destinatari per richiesta API10,000
Destinatari per campagna console50,000
Richieste al minuto per chiave600
Messaggi passati alla rete al minuto per account1,200
Testo più lungo10 segmenti (1.530 caratteri GSM-7 o 670 UCS-2)
Finestra di programmazioneda 2 minuti a 45 giorni in anticipo
Tentativi webhook per evento10
Memoria Idempotency-Key24 ore
Chiavi API per account10

File leggibili da macchina

Riferimento API Bulk SMS | Documentazione BulkSMSAPI