# GET method send SMS ``` https://app-sms.online-live-support.com/api/send.php?apiKey=[APIKEY]&recipients=[RECIPIENTS]&messageContent=[MESSAGE]&referenceID=[CUSTOMREFERENCEID] ``` | \[APIKEY] | API Key. (Find your API key at My Account > Settings) | | -------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | \[RECIPIENTS] |

Recipient mobile number.
- Mobile number with country code.
- Once recipient one request.
- One recipient one request.
- You can use semi-colon(;) to separate each recipient without space when sending multiple recipients.

| | \[MESSAGE] |

Message body.
- A single SMS may contain 160 characters, or 70 characters for Unicode.
- Concatenated SMS may contains 152 characters, or 63 characters for Unicode.
- All Malaysia mobile number will be minus 7 characters “RM0.00” at the beginning of each SMS content.
- Maximum of 10 concatenated SMS.

As per SKMM guidelines, you shall include price information at the beginning of each SMS. You shall use either “Free msg/RM0.00/Msj ini percuma” at the beginning of the SMS content. For more information, please read our Terms & Conditions.

| | \[CUSTOMREFERENCEID] | An unique reference id from your system to avoid duplicate request. | | \[STATUS] | Show the status for send SMS (**ok** / **error**) | | \[MSGCODE] | Show code to represent particular status. | | \[REFERENCEID] | Your reference for any future enquiries. | | \[BALANCE] | Your account current balance. | | \[DATA] | Each recipient sending reference ID. | ## Request and Response format **Encourage to use URL encode on the request link / url to converts reserved, unsafe, and non-ASCII characters in URLs to a format that is universally accepted and understood by all web browsers and servers. Paste it here and encode link** **Please refer to here to know more about url encoding characters reference** **Request** ] **Encoded Request** https%3A%2F%2Fapp-sms.online-live-support.com%2Fapi%2Fsend.php%3FapiKey%3D %5BAPIKEY%5D%26recipients%3D%5BRECIPIENT%5D%26messageContent%3D %5BMESSAGE%5D%26referenceID%3D%5BCUSTOMREFERENCEID%5D **Response** {"status":"\[STATUS]","msgCode":"\[MSGCODE]","statusMsg":"\[ STATUSMSG]","referenceID":"\[ REFERENCEID]"," balance":"\[ BALANCE]", "data": "\[DATA]" }\ \ \*Response array encoded with **JSON**\ \
## Example code for request and response **Request** * **Single recipient**\ 6010xxxxxxx\&referenceID=ba63ht12opab6 * **Multiple recipients**\ 6010xxxxxxx;6012xxxxxxx\&referenceID=iyr340hbc6ja0b **Encoded Request** * **Single recipient**\ https%3A%2F%2Fapp-sms.online-live-support.com%2Fapi%2Fsend.php%3F apiKey%3D22f277843206d477d3cd4ae1c9220bc3%26messageContent%3D Testing%25123%26recipients%3D6010xxxxxxx%26referenceID%3Dba63ht12opab6 * **Multiple recipients**\ https%3A%2F%2Fapp-sms.online-live-support.com%2Fapi%2Fsend.php%3F apiKey%3D22f277843206d477d3cd4ae1c9220bc3%26messageContent%3D Testing%25123%26recipients%3D6010xxxxxxx%3B6012xxxxxxx%26referenceID%3Diyr340hbc6ja0b **Response** * **Single recipient - Successful**\ {"status":"ok","msgCode":"E00001","statusMsg":"Completed successfully.","referenceID":\["q5c502192aa869"],"balance":8901,"data":\[{"recipients":"6010xxxxxxx","referenceID":"q5c502192aa869"}]} * **Multiple recipients - Successful**\ {"status":"ok","msgCode":"E00001","statusMsg":"Completed successfully.","referenceID":\["q5c5021c306a95","q5c5021c306ae8"],"balance":8901,"data":\[{"recipients":"6010xxxxxxx","referenceID":"q5c5021c306a95"},{"recipients":"6012xxxxxxx","referenceID":"q5c5021c306ae8"}]} * **Unsuccessful**\ {"status":"error","msgCode":"E00242","statusMsg":"invalid recipient(s).","invalidRecipients":\["6010999999999"]} \*Response array encoded with **JSON**
## Status Code List | Status Code | Description | | ----------- | ---------------------------------------------------- | | E00001 | Completed successfully. | | E00081 | Account not active yet. Please contact our support. | | E00242 | Invalid recipient(s). | | E00243 | Please enter your message. | | E00249 | Maximum 10 SMS per recipient(s). | | E00248 | Please enter at least one recipient. | | E00250 | Insufficient balance. | | E00253 | Maximum 100 recipient(s). | | E00359 | Invalid API Key. | | E00366 | The message content contains international brand(s). | | BE00035 | The message not allow to send without company name. | | BE00036 | The message not allow to send without whitelisted. | | BE00096 | Duplicated reference id found. | | BE00128 | Completed successfully(low balance). | --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs-sms.online-live-support.com/api-documentation/get-method-send-sms.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.