Bulk SMS API

 

 

Bulk SMS API

With the Bulk SMS API, you can integrate your systems to automatically leverage on the instant delivery of SMS to generate receipts, alerts and relevant communications to your clients and customers.

GET METHOD

URL: https://bulk.kemrut.com/sms/v3/sendsms

GET PARAMS:

  • apikey : Valide API KEY. Get this by clicking the button “GET API KEY & PARTNER ID” in your account.
  • partnerID : Valid Partner ID. Get this by clicking the button “GET API KEY & PARTNER ID” in your account.
  • message : URL Encoded Text Message with valid GSM7 Characters
  • shortcode : Valid Sender ID / Shortcode
  • mobile : Valid Mobile Number

POST METHOD

REQUEST ENDPOINT: https://bulk.kemrut.com/sms/v3/sendsms

SAMPLE REQUEST BODY

{
  "api_key":"098989789786676767YGBTFVTFCDFCTFXXDX989NHGTRDEQQE08796fg",
  "service_id":0,
  "mobile":"254707410000",
  "response_type":"json",
  "shortcode":"SENDERID",
  "message":"this is a test message",
  "date_send":"2021-01-13 16:40:00"
}
SAMPLE RESPONSE
{
    "responses": [
        {
            "respose-code": 1000,
            "response-description": "Success",
            "mobile": 25471234545,
            "messageid": 8290842,
            "networkid": "1"
        }
    ]
}

SCHEDULING MESSAGES

For messages to be sent at a future time, you will need to pass an optional parameter timeToSend with a valid date string that resolves to a Unix timestamp or the unix timestamp itself.


{
  "apikey":"123456789",
  "partnerID":"123",
  "message":"this is a test message",
  "shortcode":"SENDERID",
  "mobile":"254712345678",
  "timeToSend":"2019-09-01 18:00"
}

SENDING BULK MESSAGES

You can now send up to 20 bulk messages in one single call by using the our newest API endpoint:

API URL ENDPOINT: : https://sms.kemrut.com/api/services/sendbulk/

Sample Request Body



{
    "count": 3,
    "smslist": [
        {
            "partnerID": "12345",
            "apikey": "6565b5a73b8221",
            "pass_type": "plain",
            "clientsmsid": 1234,
            "mobile": "0733123456",
            "message": "This is a test message 1",
            "shortcode": "Kemru"
        },
        {
            "partnerID": "12346",
            "apikey": "75465b5a73b8221",
            "mobile": "0721150817",
            "clientsmsid": 1235,
            "message": "This is a test message 3",
            "shortcode": "Kemru",
            "pass_type": "plain"
        },
        {
            "partnerID": "123457",
            "apikey": "sw23454t2xd24",
            "mobile": "0721150817",
            "clientsmsid": 1236,
            "message": "This is a test message 2",
            "shortcode": "Kemru",
            "pass_type": "plain"
        }
    ]
}

Sample Response:



{
    "responses": [
        {
            "respose-code": 1000,
            "response-description": "Success",
            "mobile": "254733123456",
            "messageid": 75085465,
            "clientsmsid": "1234",
            "networkid": "2"
        },
        {
            "respose-code": 1000,
            "response-description": "Success",
            "mobile": "254711123456",
            "messageid": 75085466,
            "clientsmsid": "1235",
            "networkid": "1"
        },
        {
            "respose-code": 1006,
            "response-description": "Invalid credentials",
            "mobile": "0721150817",
            "partnerID": "1",
            "shortcode": null,
            "clientsmsid": "1236"
        }
    ]
} 
GETTING DELIVERY REPORTS

ENDPOINT URL: https://sms.kemrut.com/api/services/getdlr/

SAMPLE REQUEST BODY

{
  "apikey":"123456789",
  "partnerID":"123",
  "messageID":"123456789"
}
GETTING ACCOUNT BALANCE

ENDPOINT URL: https://sms.kemrut.com/api/services/getbalance/

SAMPLE REQUEST BODY

{
  "apikey":"123456789",
  "partnerID":"123"
}
GETTING ACCOUNT BALANCE
  • 1000;Successful Request Call
  • 1001;Invalid sender id
  • 1002;Network not allowed
  • 1003;Invalid mobile number
  • 1004;Low bulk credits
  • 1005;Failed. System error
  • 1006;Invalid credentials
  • 1007;Failed. System error
  • 1008;No Delivery Report
  • 1009;unsupported data type
  • 1010;unsupported request type
  • 4090;Internal Error. Try again after 5 minutes
  • 4091;No Partner ID is Set
  • 4092;No API KEY Provided
  • 4093;Details Not Found