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