Documentation

Summary of Ginota SMS APIs

Here is a summarized list of Ginota SMS API available for easy integration anytime, anywhere.

To Send A Single SMS

Sample Request
https://www.ginota.com/gemp/sms/json?apiKey=GinotaAPIKey&apiSecret=GinotaAPISecret&srcAddr=Ginota&dstAddr=60123456789&content=Hello+Ginota
API URLParameter(s)
https://www.ginota.com/gemp/sms/json? apiKey *HTTP URL friendly. Do not require further encoding
apiSecret *required to be URL encoded
srcAddr
dstAddr
content *required to be UTF-8 and URL encoded
type
udh
url
flash
dlr
txnRef
ttl
at
channel

To Send Bulk SMS

Sample Request
https://www.ginota.com/gemp/bulk/sms/json?apiKey=GinotaAPIKey&apiSecret=GinotaAPISecret&srcAddr=Ginota&dstAddrs=60123456789%2C60173871877%2C60173871878&content=Hello+Ginota
API URLParameter(s)
https://www.ginota.com/gemp/bulk/sms/json? apiKey *HTTP URL friendly. Do not require further encoding
apiSecret *required to be URL encoded
srcAddr
dstAddrs *required to be UTF-8 and URL encoded
For multiple MSISDNs, each destination numbers must be separated with commas (,)
content *required to be UTF-8 and URL encoded
type
udh
url
flash
dlr
txnRef
ttl
at
channel

To check Ginota account credit balance

Sample Request
https://www.ginota.com/gemp/balance?apiKey=GinotaAPIKey&apiSecret=GinotaAPISecret
API URLParameter(s)
https://www.ginota.com/gemp/balance? apiKey *HTTP URL friendly. Do not require further encoding
apiSecret *required to be URL encoded

To check Discover Mobile Status

Sample Request
https://www.ginota.com/gemp/otp/discoverMobileStatus?apiKey=GinotaAPIKey&apiSecret=GinotaAPISecret&userId=support@ginota.com
API URLParameter(s)
https://www.ginota.com/gemp/otp/discoverMobileStatus? apiKey *HTTP URL friendly. Do not require further encoding
apiSecret *required to be URL encoded
userId *email address of the subscriber

To check Discover Mobile Number

Sample Request
https://www.ginota.com/gemp/otp/discoverMobile?apiKey=GinotaAPIKey&apiSecret=GinotaAPISecret&email=support@ginota.com&sName=Support
API URLParameter(s)
https://www.ginota.com/gemp/otp/discoverMobile? apiKey *HTTP URL friendly. Do not require further encoding
apiSecret *required to be URL encoded
email *email address of the subscriber
sName

To send OTP

Sample Request
https://www.ginota.com/gemp/otp/sendOTP?apiKey=GinotaAPIKey&apiSecret=GinotaAPISecret&userId=60122772266
API URLParameter(s)
https://www.ginota.com/gemp/otp/sendOTP? apiKey *HTTP URL friendly. Do not require further encoding
apiSecret *required to be URL encoded
userId *MSISDN of the subscriber
pinValidity *value in seconds. Default is 300secs (5 mins). No max limit

To verify OTP

Sample Request
https://www.ginota.com/gemp/otp/verifyOTP?apiKey=GinotaAPIKey&apiSecret=GinotaAPISecret&requestId=R89Hjkk8999&otp=88990
API URLParameter(s)
https://www.ginota.com/gemp/otp/verifyOTP? apiKey *HTTP URL friendly. Do not require further encoding
apiSecret *required to be URL encoded
requestId *HTTP response request ID from sendOTP API
otp *value input by customer

Subscribe today and get a free trial

GET ME CONNECTED!

No credit cards required