Skip to content

Developers

SMS API for Zimbabwe

Send SMS to Econet, NetOne and Telecel through a REST API, with public docs, flat USD prices and delivery reports through webhooks.

Create free account

Free to create. Sending needs a top-up, and there are no free credits.

Read the API docs
curl https://api.sms.ansa.co.zw/v1/messages \  -H "Authorization: Bearer YOUR_API_KEY" \  -H "Idempotency-Key: order-1042" \  -H "Content-Type: application/json" \  -d '{"to":"+263771234567",       "from":"MUFAROHIGH",       "text":"Your results are ready."}'
Response
{  "id": "msg_7f3a",  "status": "queued",  "network": "econet",  "parts": 1,  "cost_usd": "0.015"}

Quickstart

  1. 01Create an account and top up.
  2. 02Create an API key in the dashboard. It's shown once, so keep it safe.
  3. 03Send a message to your own number and check the delivery status.

What your key can do

The same key works at every stage. What it can send grows as your account is verified.

  • Topped upSend to your own number only
  • ID verifiedSend to any number fromANSA
  • Business verifiedSend to any number from your own sender ID

Endpoints

Base URLhttps://api.sms.ansa.co.zw

  • POST/v1/messagesSend one message
  • POST/v1/messages/otpSend a login code
  • POST/v1/batchesSend to many numbers
  • GET/v1/messages/{id}Get a message
  • GET/v1/messagesList messages
  • GET/v1/batches/{id}Get batch progress
  • GET/v1/balanceGet your balance
  • GET/v1/sender-idsList your sender IDs

Delivery webhooks

Register a URL and we'll send you the result for each message. Requests are signed with HMAC-SHA256 so you can check they came from us.

Statuses

  • queued
  • sent
  • delivered
  • undelivered
  • rejected
Webhook samplePOST to your URL
{  "id": "msg_7f3a",  "status": "delivered",  "network": "econet",  "parts": 1,  "cost_usd": "0.015"}

Built for real integrations

Errors

  • 402insufficient_balanceTop up to keep sending.
  • 403recipient_not_allowedVerify your account.
  • 403sender_not_approvedThis sender ID isn't approved for your account.
  • 422invalid_numberThe number isn't a valid Zimbabwean mobile number.
  • 429rate_limitedSlow down and try again.

Pricing and message length

1.5c

Econet and Telecela message, in USD

1.7c

NetOnea message, in USD

Standard characters
160 in one part, or 153 per part when longer.
Emoji and some special characters
70 in one part, or 67 per part when longer.
Undelivered messages
You're charged only if the network charges for them.

Test it on your own phone

Top up, text yourself, and see the delivery report before you message a customer.

Create free account

Free to create. Sending needs a top-up, and there are no free credits.