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.
As a developer, the following two methods will greatly assist you to implement this service to your systems.
-
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
GET PARAMS
SAMPLE REQUEST BODY
“
”
{
"apikey":"123456789",
"partnerID":"123",
"message":"this is a test message",
"shortcode":"SENDERID",
"mobile":"254712345678"
}
”
{
"apikey":"123456789",
"partnerID":"123",
"message":"this is a test message",
"shortcode":"SENDERID",
"mobile":"254712345678"
}
For a successfully sent message you get:
SAMPLE RESPONSE
“
”
{
"responses": [
{
"respose-code": 200,
"response-description": "Success",
"mobile": 254712345678,
"messageid": 8290842,
"networkid": "1"
}
]
}
”
{
"responses": [
{
"respose-code": 200,
"response-description": "Success",
"mobile": 254712345678,
"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"
}
”
{
"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.jazaafrica.com/api/services/getdlr/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": "JazaAfrica"
},
{
"partnerID": "12346",
"apikey": "75465b5a73b8221",
"mobile": "0711123456",
"clientsmsid": 1235,
"message": "This is a test message 3",
"shortcode": "JazaAfrica",
"pass_type": "plain"
},
{
"partnerID": "123457",
"apikey": "sw23454t2xd24",
"mobile": "0755123456",
"clientsmsid": 1236,
"message": "This is a test message 2",
"shortcode": "JazaAfrica",
"pass_type": "plain"
}
]
}
”
{
"count": 3,
"smslist": [
{
"partnerID": "12345",
"apikey": "6565b5a73b8221",
"pass_type": "plain",
"clientsmsid": 1234,
"mobile": "0733123456",
"message": "This is a test message 1",
"shortcode": "JazaAfrica"
},
{
"partnerID": "12346",
"apikey": "75465b5a73b8221",
"mobile": "0711123456",
"clientsmsid": 1235,
"message": "This is a test message 3",
"shortcode": "JazaAfrica",
"pass_type": "plain"
},
{
"partnerID": "123457",
"apikey": "sw23454t2xd24",
"mobile": "0755123456",
"clientsmsid": 1236,
"message": "This is a test message 2",
"shortcode": "JazaAfrica",
"pass_type": "plain"
}
]
}
Sample Response:
“
”
{
"responses": [
{
"respose-code": 200,
"response-description": "Success",
"mobile": "254733123456",
"messageid": 75085465,
"clientsmsid": "1234",
"networkid": "2"
},
{
"respose-code": 200,
"response-description": "Success",
"mobile": "254711123456",
"messageid": 75085466,
"clientsmsid": "1235",
"networkid": "1"
},
{
"respose-code": 1006,
"response-description": "Invalid credentials",
"mobile": "0755123456",
"partnerID": "1",
"shortcode": null,
"clientsmsid": "1236"
}
]
}
”
{
"responses": [
{
"respose-code": 200,
"response-description": "Success",
"mobile": "254733123456",
"messageid": 75085465,
"clientsmsid": "1234",
"networkid": "2"
},
{
"respose-code": 200,
"response-description": "Success",
"mobile": "254711123456",
"messageid": 75085466,
"clientsmsid": "1235",
"networkid": "1"
},
{
"respose-code": 1006,
"response-description": "Invalid credentials",
"mobile": "0755123456",
"partnerID": "1",
"shortcode": null,
"clientsmsid": "1236"
}
]
}
Lorem Ipsum is simply dummy text of the printing and typesetting in dustry lorem Ipsum has been the industrys standard dummy text ev er since the 1500s, when an unknown printer took a galley of type and scrambled it to make a type specimen book. It has survived not only five centuries, but also the leap into electronic industry.
Need support ? contact our team
24/7 Support