Get SMS cost

Africans best sms delivery
SMS TODAY: processing sms made simple
Release 1.2.

You may sometimes want know how much an sms will cost before sending, you can archive this by calling billing system as bellow

End point

Below is a list of all required arguments that needs to be sent in the POST request:

Request Type: POST
Parameter Required Description
text YES A not less than 5-character value that will be delivered to phone/s attached
numbers YES Phone numbers can be in local(10 chars) or international (13 chars) format without plus(+) sign.
For bulk sms, numbers can be separated by a comma(,) e.g xxx,xxx,xxx
api_key YES The value of api_key identifies the user within the system when interacting with the api. You obtain this by registering on
Register here
password YES Your SMS TODAY account password

The sample code below is all that is required to integrate Sms today into your application/websites. curl -X POST -F text=hello world&numbers=xxx1,xxx2&api_key=0000&password=000


Response is always on json format where you're required to decode into your workspace language

json string which the server reply to your call

Response Type: JSON { "type":"success", "msg":"fetchSMSInfo", "code":"200", "feedback": { "balance":"CURR 13,388.20", "actualBalance":"CURR 13,462.40", "cost":"CURR 74.20" } }

json string explained

Parameter Description Example
type Their are number of request type response

success indicated that the request was made successful
info indicated that the request wasn't made successful If you may encounter response "info" it means the request is not POST or the requested resource is not available within the api

msg This contains the response message in a human readable request was successful, request wasn't successful
code Depending on the que status the api can replay with number of request codes, these codes indicates that the request succeed or not

200 request was successful
400 Invalid api key
700 Undefined required field

Note: Status 200 is generated once a single message satisfied the gateway for delivery.
feedback Contains detailed description of the billing and your balance

balance indicates what will be your balance when messages sent
actualBalance indicates your current balance
cost indicates total amount the service will cost when triggered

balance CURR 13,388.20
actualBalance CURR 13,462.40
cost CURR 74.20