One JSON request delivers the code to any Zain, Ooredoo, STC or Virgin number, including numbers on the Do Not Disturb list. KWD 0.015 a message, and testing is free.
No documents, no payment, no limit on testing.
# test 1 queues the message and delivers nothing curl -s -X POST 'https://www.kwtsms.com/API/send/' \ -H 'Content-Type: application/json' \ -H 'Accept: application/json' \ -d '{ "username": "your_api_user", "password": "your_api_pass", "sender": "YOUR-SENDER", "mobile": "965XXXXXXXX", "message": "Your OTP for Acme is: 123456", "test": "1" }'
{ "result": "OK", "msg-id": "f4c841adee210f31307633ceaebff2ec", "numbers": 1, "points-charged": 1, "balance-after": 180, "unix-timestamp": 1684763355 }
Four steps. Nothing to sign, nothing to pay until you go live.
A mobile number and an email. No documents.
From inside your account. The API username and password are a separate pair from your login.
KWD 14.950, one time. It reaches Do Not Disturb numbers, which a promotional ID does not. Allow 5 working days or more after we receive your signed forms.
Until then send with "test":"1": queued, never delivered, and its credits come back when you delete it from the queue. Minimum order 1,000 messages, KWD 15.
One message is one credit on every Kuwaiti network. Credits never expire.
| Quantity | Price per message |
|---|---|
| 1,000 to 49,999 | KWD 0.015 |
| 50,000 to 99,999 | KWD 0.0145 |
| 100,000 and above | KWD 0.014 |
| Private Sender ID, one time | KWD 10 promotional, KWD 14.950 transactional |
points-charged and balance-after.One JSON object per send: the message id, what it cost, and the balance left.
| Field | What it is |
|---|---|
result | OK, or ERROR with a code and a description. |
msg-id | The handle for this send. Store it: /API/status/ takes it, and support asks for it first. |
numbers | How many submitted numbers were accepted. |
points-charged | Credits deducted. One per message part. |
balance-after | Your balance after this send. |
unix-timestamp | Server time, Asia/Kuwait (GMT+3). |
| Code | Meaning and fix |
|---|---|
ERR003 | Wrong API username or password. Not your account mobile number. |
ERR006 | No valid number in the request. |
ERR011 | Not enough credits. |
ERR025 | The number holds a non-digit. Strip +, 00, spaces and dashes. |
ERR028 | Sent to the same number too soon. |
Errors use the same envelope: result, code, description. Branch on the code, log the description.
What an OK response proves, and what nobody in Kuwait can prove.
It is not a delivery receipt.
/API/status/ takes a msg-id and reports whether the message left our queue. A stuck message can be deleted, and the credit comes back./API/dlr/ returns delivery reports for international numbers only.Zain, Ooredoo, STC and Virgin do not send one to any provider, so none can pass it on.
msg-id at send time. A trace has nothing to look up without it.Four rules, and the code stays one credit.
Official client libraries and a command line tool. Install it, set your Sender ID, send.
One POST to https://www.kwtsms.com/API/send/ with six fields: username, password, sender, mobile, message and test, with Content-Type: application/json. A request takes up to 200 numbers, but for OTP send one number per request so each code has its own msg-id.
A transactional one, KWD 14.950 one time. It reaches numbers on the Do Not Disturb list, which Zain and Ooredoo operate. A promotional ID is filtered there and the credit is still charged. Registration takes 5 working days or more after we receive your signed forms.
Yes. Send with "test":"1". The message is queued and never delivered. Its credits are held until you delete it from the sending queue of your account.
No. Kuwaiti carriers return none, so nobody can offer one. /API/status/ shows whether the message left our queue, and /API/dlr/ answers for international numbers only.
Wait at least 60 seconds before you show a resend button, and send a new code each time.
In this order: is test still 1; is the message in the sending queue rather than the archive (delete it and the credit returns); is the number international digits only, no plus, no leading zeros; is the Sender ID transactional. If all four are clean, send us the msg-id.
Test credits included. No papers, no payment, ready in a minute.