Sender.Ge API reference

The Sender.Ge API follows RESTful principles, providing resource-oriented URLs and common HTTP response codes to indicate API errors. All query parameters are case sensitive.

Authentication

apikey

All requests are authenticated using an API key. Please contact us to obtain an API key.

Security scheme type: API Key
header parameter name: apikey

Send SMS

http request methods



example for send single SMS

GET

https://sender.ge/api/send.php?apikey=apikey&smsno=value&destination=mobile&content=message

POST

https://sender.ge/api/send.php

function send_sms($url,$apikey,$smsno=1,$destination,$content){
    $fields = array(
       'apikey' => $apikey,
       'smsno' => $smsno,
       'destination' => $destination,
       'content' => $content
    );
    $fields_string = http_build_query($fields);
    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, $url);
    curl_setopt($ch, CURLOPT_POST, true);
    curl_setopt($ch, CURLOPT_POSTFIELDS, $fields_string);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    $output = curl_exec($ch);
    $httpcode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    curl_close($ch);
    return $output;
}


query parameters

apikey A unique key for using API which contains Sender title
smsno
value description purpose
1 with SmsNo function advertising
2 without SmsNo function information
destination 9 Digit mobile number without +995 .

Only Georgian mobile operators numbers

content Message, any unicode characters are allowed

response parameters

messageId A unique messageId
qnt Sms quantity
statusId
value description
1 Sent

Http Response Codes

200 OK


										

401 Unauthorized


										

402 Payment Required


										

403 Forbidden


										

503 Service Unavailable


										

Get Balance

http request methods



example for get balance

GET

https://sender.ge/api/getBalance.php?apikey=apikey

POST

https://sender.ge/api/getBalance.php

function get_balances($url,$apikey){
    $fields = array(
       'apikey' => $apikey
    );
    $fields_string = http_build_query($fields);
    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, $url);
    curl_setopt($ch, CURLOPT_POST, true);
    curl_setopt($ch, CURLOPT_POSTFIELDS, $fields_string);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    $output = curl_exec($ch);
    $httpcode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    curl_close($ch);
    return $output;
}


query parameters

apikey A unique key for get balance

response parameters

balance Current Balance
overdraft Current Overdraft

Http Response Codes

200 OK


										

404 Not found


										

Delivery Reports

http request methods



example for get delivery report

GET

https://sender.ge/api/callback.php?apikey=apikey&messageId=messageId

POST

https://sender.ge/api/callback.php

function callback_sms($url,$apikey,$messageId){
    $fields = array(
       'apikey' => $apikey,
       'messageId' => $messageId
    );
    $fields_string = http_build_query($fields);
    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, $url);
    curl_setopt($ch, CURLOPT_POST, true);
    curl_setopt($ch, CURLOPT_POSTFIELDS, $fields_string);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    $output = curl_exec($ch);
    $httpcode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    curl_close($ch);
    return $output;
}


query parameters

apikey A unique key for using API
messageId A unique messageId

response parameters

messageId A unique messageId
statusId
value description
0 Pending
1 Delivered
2 Undelivered
timestamp Delivery date time

Http Response Codes

200 OK


                                        

401 Unauthorized


                                        

403 Forbidden


                                        

503 Service Unavailable