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