Reach every phone in Rwanda.

Billed per segment.
Never on credit.

Delivered to phones on

  • MTN
  • Airtel

The messages your app has to get right.

Verification codes

One-time codes that reach the phone while the person is still on the screen. Add an idempotency key and a retry never sends twice.

Read the API

Alerts

Payment, delivery and account alerts, with the network’s receipt for each one: delivered, failed, expired or rejected.

SMS basics

Notifications

Reminders and updates to everyone who has not replied STOP. Opt-outs are handled for you.

See pricing

The API

One request per message.

POST the number and the text with an API token that can send SMS. Add an idempotency key and a retry never sends twice.

Send an SMS

$ curl https://api.bweze.com/v1/messages \
    -H "Authorization: Bearer $BWEZE_API_KEY" \
    -H "Content-Type: application/json" \
    -H "Idempotency-Key: order-1042" \
    -d '{"to": "+250788123456",
         "body": "Your code is 482910"}'
✓ {"id": "…", "status": "sent", "segments": 1}

Messages you can account for.

15 RWF a segment. GSM-7 fits 160 characters in one segment; an emoji switches the message to UCS-2, which fits 70.

A reply of STOP puts the number on your opt-out list and the API stops messaging it; START takes it off.

Every message keeps the receipts the network sends back, with the network’s reason when it fails.

Top up with mobile money. Each send holds its cost against your balance, so a message is refused, never sent on credit.

A message only counts when it arrives.

Asked before sending.

How is an SMS billed?

Per segment. A message in the GSM-7 alphabet fits 160 characters in one segment and 153 per segment when it is longer. A message with a character outside it, such as an emoji, uses UCS-2, which fits 70 characters in one segment and 67 per segment when longer. A send is refused before it costs anything if it would be over 10 segments.

Do I find out whether a message arrived?

Yes. Each message records the delivery receipts the network sends back, so you can see whether it was delivered, failed, expired or was rejected, and the network’s reason.

What happens when someone replies STOP?

Their number joins your workspace’s opt-out list and the API refuses to message it with recipient_opted_out. Replying START takes it off the list. You can also add or remove a number yourself.

Can I retry a send without sending twice?

Yes. Send an idempotency key with the message; a retry with the same key returns the first result instead of sending again.

How do I pay?

Top up your BWEZE wallet with mobile money. Each send holds its cost against your balance, so a message is refused rather than sent on credit when the balance is too low.

Send the first message from Kigali.

Join the waitlist