Send A Premium SMS via HTTP (MT) Example

Learn how to send a Premium SMS MT message.

GET /srs/api/sendsms

Send a Premium MT SMS message to a MSISDN.

Curl

curl -XGET -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=<AMOUNT>&NETWORK=<NETWORK PROVIDER>'

Python

import requests

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

response = requests.get(
    '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=<AMOUNT>&NETWORK=<NETWORK PROVIDER>',
    headers=headers,
)

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

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.