OTP SMS API, Kuwait

Send your first OTP in one POST request.

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.

  • KWD 0.015 a message
  • Reaches DND numbers
  • 12 SDKs
  • Free to test

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"
  }'

How to start

Four steps. Nothing to sign, nothing to pay until you go live.

  1. 1

    Open a free account

    A mobile number and an email. No documents.

  2. 2

    Request API access

    From inside your account. The API username and password are a separate pair from your login.

  3. 3

    Register a transactional Sender ID

    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.

  4. 4

    Buy credits and set test to 0

    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.

What it costs

One message is one credit on every Kuwaiti network. Credits never expire.

QuantityPrice per message
1,000 to 49,999KWD 0.015
50,000 to 99,999KWD 0.0145
100,000 and aboveKWD 0.014
Private Sender ID, one timeKWD 10 promotional, KWD 14.950 transactional

For an OTP that means

  • A code under 160 characters, or 70 in Arabic, is one credit.
  • Minimum order 1,000 messages, KWD 15.
  • A promotional Sender ID is filtered on Do Not Disturb numbers and the credit is still charged. OTP needs the transactional one.
  • Every response carries points-charged and balance-after.

What comes back

One JSON object per send: the message id, what it cost, and the balance left.

Success fields

FieldWhat it is
resultOK, or ERROR with a code and a description.
msg-idThe handle for this send. Store it: /API/status/ takes it, and support asks for it first.
numbersHow many submitted numbers were accepted.
points-chargedCredits deducted. One per message part.
balance-afterYour balance after this send.
unix-timestampServer time, Asia/Kuwait (GMT+3).

The errors you will hit

CodeMeaning and fix
ERR003Wrong API username or password. Not your account mobile number.
ERR006No valid number in the request.
ERR011Not enough credits.
ERR025The number holds a non-digit. Strip +, 00, spaces and dashes.
ERR028Sent to the same number too soon.

Errors use the same envelope: result, code, description. Branch on the code, log the description.

Did it arrive?

What an OK response proves, and what nobody in Kuwait can prove.

OK means accepted, charged and handed to the carrier

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.

Kuwaiti networks return no per-message receipt

Zain, Ooredoo, STC and Virgin do not send one to any provider, so none can pass it on.

  • For OTP, the code typed back is the receipt. Track how many codes are entered inside your expiry window: that rate moves the moment delivery degrades.
  • Keep the msg-id at send time. A trace has nothing to look up without it.

Arabic codes

Four rules, and the code stays one credit.

  • One Arabic character makes the whole message Unicode: 70 characters per message, 67 per part when it splits. Under 70 is one credit.
  • Write the code itself in Latin digits, even inside Arabic text. Arabic-Indic digits are typed back inconsistently.
  • Post the body as UTF-8 JSON. It is delivered character for character.
  • No emoji. It forces Unicode (70 characters), and the free KWT-SMS sender refuses it.

Your language is ready

Official client libraries and a command line tool. Install it, set your Sender ID, send.

  • PHP
  • Python
  • JavaScript
  • Ruby
  • Go
  • Java
  • C#
  • Swift
  • Kotlin
  • Rust
  • Dart
  • Zig
  • kwtsms-cli
See the code for every language

Questions developers ask

What is the smallest integration that works?

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.

Which Sender ID do I need?

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.

Can I develop without spending credits?

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.

Do I get a delivery report for a Kuwait number?

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.

How soon can I resend to the same number?

Wait at least 60 seconds before you show a resend button, and send a new code each time.

The code did not arrive. Where do I look?

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.

Try kwtSMS free today

Test credits included. No papers, no payment, ready in a minute.

Open a free account