Send SMS via the iSMS REST API endpoint. Same parameters and response codes as the HTTPS SMS API — compatible with any programming language or platform.
Initiate an HTTP GET or POST request to the REST endpoint below. All parameters are identical to the HTTPS SMS API.
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
| un | String | Required | iSMS account username | myusername |
| pwd | String | Required | iSMS account password | mypassword |
| dstno | String | Required | Destination number in international format (e.g. 601X-XXXXXXX). Separate multiple numbers with semicolons. | 601X-XXXXXXX |
| msg | String | Required | Text of the message to be sent. Must be URL-encoded for GET requests. | Hello%20World |
| type | Integer | Required | 1 = ASCII (English, BM) · 2 = Unicode (Chinese, Japanese) | 1 |
| agreedterm | String | Required | Must be set to YES to accept iSMS User Agreement | YES |
| sendid | String | Optional | Sender ID — alphanumeric, max 11 characters. Malaysia prefix does not support Sender ID. | MyBrand |
$params = [
"un" => "myusername",
"pwd" => "mypassword",
"dstno" => "601X-XXXXXXX",
"msg" => "Hello from iSMS REST API",
"type" => "1",
"agreedterm" => "YES"
];
$ch = curl_init("https://www.isms.com.my/RESTAPI.php");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($params));
$result = curl_exec($ch);
curl_close($ch);
// Success: "2000 = SUCCESS:1143007207"
echo $result;Upon message submission, iSMS returns a response code for each request.
| Code | Description | Details |
|---|---|---|
| 2000 = SUCCESS:trx_id | Message pushed to Telco SMSC | trx_id is the unique SMS Transaction ID. Note: confirms submission to Telco SMSC only — not handset delivery. |
| -1000 | Unknown error | Contact administrator |
| -1001 | Authentication failed | Incorrect username or password |
| -1002 | Account suspended / expired | Contact administrator |
| -1003 | IP not allowed | Your server IP is not whitelisted — contact support |
| -1004 | Insufficient credits | Reload your credits at buy_reload.php |
| -1005 | Invalid SMS type | Must be 1 or 2 |
| -1006 | Invalid body length | Message exceeds max 700 characters |
| -1008 | Missing parameter | One or more required parameters absent |
| -1009 | Invalid destination number | Not a valid international format |
| -1013 | Invalid term agreement | Add agreedterm=YES to your request |
See the full SMS API documentation for delivery callbacks, bulk JSON sending, multiple endpoints, and language-specific code examples.
📞 1800 87 7061 · +603 2780 3880 · [email protected]