Mobitech Bulk SMS API

Api intergration.

Mobitech Bulk Sms offers you an api endpoint that you can quickly pluck your wonderful existing system into our bulk sms platform and seamlessly send bulk sms to your clients with less hustle.

Base URLs

  • HTTPS URL
  • https://bulk.api.mobitechtechnologies.com/
  • HTTP URL
  • http://bulksms.mobitechtechnologies.com/

Endpoints

Type Params Method End Point URL
Send SMS api_key, username, sender_id, message, phone POST api/sendsms
Delivery Status api_key, username, message_id POST api/sms_delivery_status
SMS Units Balance api_key, username POST api/account_balance

Send SMS

The api endpoint is a RESTFUL API
To send sms - You make a POST Request to this endpoint http://bulksms.mobitechtechnologies.com/api/sendsms

The following parameters are required.

  1. api_key: - Found at your account My Account
  2. username: your username at the bulks sms portal - used to login
  3. sender_id - This is the assigned sender name e.g 22136 [default one if not assigned any]
  4. message - The message to be send e.g "Hello welcome to Mobitech Bulk sms"
  5. phone - The recepients to receive the message e.g 2547XXXXXXX
    Note: Phone can be multiple numbers separated by a comma e.g "2547000000,2547210000,..."

sample sending sms api call

                  
                      //send sms
                      //endpoint http://bulksms.mobitechtechnologies.com/api/sendsms
                      {
                        "api_key":"YOUR_API_KEY",
                        "username":"YOUR_USER_NAME",
                        "sender_id":"YOUR_ASSIGNED SENDER ID",
                        "message":"MESSAGE_TO_SEND",
                        "phone":"RECEPIENT-2547xxxx //can be multiple numbers separated by commas ',' "
                      }

                      //response
                      [
                        {
                            "status": "200",
                            "response": "success",
                            "message_id": 37173312,
                            "recipient": "254702739804"
                        }
                      ]
                  
                

Check SMS Delivery Status

To check an sms delivery status
  1. Make a POST request to the following endpoint
    http://bulksms.mobitechtechnologies.com/api/sms_delivery_status
  2. Parameters required:
    • api_key: - Found at your account My Account
    • username: your username at the bulks sms portal - used to login
    • message_id : return as part of message sent successfully response
Sample sms delivery status request
                
                    //check delivery status
                    //endpoint - http://bulksms.mobitechtechnologies.com/api/sms_delivery_status
                    {
                      "api_key":"YOUR_API_KEY",
                      "username":"YOUR_USER_NAME",
                      "message_id": returned as part of success respone - {integer value}
                    }

                  
                
              
SMS Delivery Report status. Response Body
                  
                      //Response body
                      {
                        "status_code":200,
                        "message_id":"MESSAGE_ID",
                        "message":"THE MESSAGE",
                        "recepient":"PHONE_NUMBER",
                        "send_time":"SEND_DATE_TIME",
                        "sender_name":"SENDER_ID",
                        "status":"DELIVERY STATUS",
                        "sms_unit":"NO. OF SMS UNITS",
                        "network_name":"NETWORK NAME",
                        "dateCreated":"2020-05-30 18:39:01"
                      }
  
                    
                  
                

Check My SMS Credit

To check your sms credit
  1. Make a POST request to the following endpoint
    http://bulksms.mobitechtechnologies.com/api/account_balance
  2. Parameters required:
    • api_key: - Found at your account My Account
    • username: your username at the bulks sms portal - used to login
Sample sms credit request
                
                    //check balance
                    //endpoint - http://bulksms.mobitechtechnologies.com/api/account_balance
                    {
                      "api_key":"YOUR_API_KEY",
                      "username":"YOUR_USER_NAME"
                    }

                    //expected response
                    {"balance":TOTAL SMS UNITS BALANCE}