Start sending SMS using our API | Method 2 | Simple Integration – authentication token send via request parameters

Integrate SMS functionality into your application using your programming language.

Base URL

All URLs referenced in the API documentation have the following base url.

https://portal.richmo.lk

Note : All the query string parameters in the URL must be UTF-8 URL Encoded

Send a single message

HTTP request

GET /api/v1/sms/send/

Parameters

Parameter	Type	Description	Required
dst	String	Recipent phone number.	Required
from	String	The Sender name.(Mask)	Required
msg	String	The body of the message.	Required
key	String	Authentication token	Required

Returns

Code	Description	Message Example
200	Success	{ “message”: “success”, “id”: 69412 }
400	Bad Request such as missing required parameter.	{ “errors”: { “destination”: [ “This field may not be blank.” ] } }
401	Unauthorized : Errors like invalid token	{ “detail”: “Invalid token.” }

Code Samples

Curl

curl --request GET 'https://portal.richmo.lk/api/sms/send/?dst=947xxxxxxxx&from=[mask]&msg=[UTF-8 URL Encoded Message]&key=[API TOKEN]'

PHP Curl

$curl = curl_init();
curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://portal.richmo.lk/api/sms/send/?dst=947xxxxxxxx&from=[mask]&msg=[UTF-8 URL Encoded Message]&key=[API TOKEN]',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_CUSTOMREQUEST => 'GET',
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

Python-Request

import requests

url = "https://portal.richmo.lk/api/sms/send/?dst=947xxxxxxxx&from=[mask]&msg=[Your Message]&key=[API TOKEN]"
payload={}
headers = {}
response = requests.request("GET", url, headers=headers, data=payload)
print(response.text)