SMS API

Send Single SMS

POST /v1/sms/send

Name	Type	Required	Description
`to`	string	Yes	Recipient phone number (international format)
`message`	string	Yes	SMS message text
`sender_id`	string	No	Custom sender ID


{
  "to": "+255712345678",
  "message": "Your verification code is 4921.",
  "sender_id": "SendAfrika"
}

Billing: 1 credit per 160 standard characters (1 SMS part).

POST /v1/sms/bulk

Name	Type	Required	Description
`recipients`	string[]	Yes	List of recipient phone numbers
`message`	string	Yes	SMS message text
`sender_id`	string	No	Custom sender ID

GET /v1/sms/status/:message_id

Status Values: queued, sent, delivered, failed, expired

GET /v1/sms/logs

Name	Type	Default	Description
`limit`	integer	10	Number of logs to retrieve

GET /v1/contacts — List contacts in the account phonebook.

GET /v1/contacts/search — Search contacts by name or phone number.

POST /v1/campaigns

Name	Type	Required	Description
`name`	string	Yes	Campaign name
`message`	string	Yes	Campaign message text
`contact_group_id`	string	Yes	Target contact list ID
`scheduled_at`	string	No	UTC timestamp for scheduled delivery

GET /v1/credits/balance — Check SMS credit and wallet balance.

POST /v1/vouchers/initiate — Initiate a mobile money top-up via Snippe.

Name	Type	Required	Description
`phone_number`	string	Yes	Phone number for USSD push
`amount_tzs`	integer	Yes	Amount in Tanzanian Shillings

Supported Payment Methods: M-Pesa, Tigo Pesa, Airtel Money, Halopesa