SMS REST API

POST {{baseUrl}}/api/sms/send

Authorization: Bearer kfsms_your_token
Content-Type: application/json

curl -X POST "{{baseUrl}}/api/sms/send" \
  -H "Authorization: Bearer kfsms_your_token" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+255700000000",
    "sender": "APPROVED",
    "text": "Your booking is confirmed for Friday at 6pm."
  }'

GET {{baseUrl}}/api/sms/balance

curl "{{baseUrl}}/api/sms/balance" \
  -H "Authorization: Bearer kfsms_your_token"

GET {{baseUrl}}/api/sms/logs?limit=50

curl "{{baseUrl}}/api/sms/logs?limit=50" \
  -H "Authorization: Bearer kfsms_your_token"

{
  "success": true,
  "message": "SMS accepted",
  "data": {
    "reference": "sms_...",
    "recipient": "255700000000",
    "sender": "APPROVED",
    "segments": 1,
    "status": "sent"
  }
}

{
  "success": false,
  "message": "Sender name is not approved"
}