Send SMS via HTTP (MT) Example

This document will go over executing API calls and provide examples.

GET /srs/api/sendsms

Send a customisable SMS message to a MSISDN.

Please note you must URL encode the MESSAGE_TEXT parameter and VALUE must be set to 0 for a free message.

Curl

curl -X GET -H "Content-type: application/json" 'https://hostname/srs/api/sendsms?USER_NAME=<account_id>&PASSWORD=<api_key>&ORIGINATOR=<SHORT CODE>&RECIPIENT=<MSISDN>&PROVIDER=<Network Provider>&KEYWORD=<Keyword>&MESSAGE_TEXT=Hello%20There!&VALUE=0'

Python

import requests

headers = {
    'Content-type': 'application/json',
}

data = 'USER_NAME=<account_id>&PASSWORD=<api_key>&ORIGINATOR=<SHORT CODE>&RECIPIENT=<MSISDN>&PROVIDER=<Network Provider>&KEYWORD=<Keyword>&MESSAGE_TEXT=Hello%20There!&VALUE=0'

response = requests.get('http://hostname/srs/api/sendsms', headers=headers, data=data)

Headers

Name	Value
Content-Type	application/json
Authorization	No Auth

Body

Parameter	Type	Example	Description
account_id	string	43e36f50aaf111e272639171000000a9	Your unique Mobivate account id.
password	string	3b41d767316541bacef19d1382ac1e12	Your unique associated Mobivate account api-key.
originator	integer	12345	The associated shortcode for your service.
recipient	integer	XX7432104492	The recipient you want to send this message to.
provider	string	Safaricom	The network you plan to send the SMS message via.
keyword	string	mv-100620006	Your unique Mobivate keyword for your service.
message_text	string	Hello%20There!	The body of the text message you want to send.
value	integer	10	The cost of receiving this SMS message.

Response

200

{
  "MT-aabbccddeeff00112233445566778899"
}

511

{
  "error": "Username or Password incorrect"
}

Be aware for Premium SMS the cost must be set or the Short code's default value will be charged.