SMS & Viber API Documentation

Overview

premium-sms.gr is a high quality SMS service that enables your applications to integrate with our SMS messaging system. It offers a plain simple yet powerful and dynamic implementation.
You can use your company name as the sender name of the messages and you will receive a delivery report for each one within seconds.

To start using premium-sms.gr you need to sign up free of charge.
Your account is ready to use right away and 5 sms will be added to test the quality of the service.

All API calls are authenticated the API key generated for your account. Only exception is the api/mobile/check endpoint, which is free to use without authentication (enter your mobile below to try it). You can reset the key to a new one anytime you need.

SMS API demonstration + testing

Check the SMS API demonstration as "demo" user
or enter your own username and password

Username

Password

REST SMS API

This is the 3^rd version of the SMS API, it is a superset of the previous versions and therefore backwards compatible with both the 2^nd version and the deprecated v. 1

All API calls can be secured (https) or not (http)
All API call parameters can be passed via GET or POST
Default input encoding is the web standard UTF-8
Mobile numbers are parsed, formated and stored in MSISDN format (Mobile Station International Subscriber Directory Number)

api/mobile

The api/mobile/check endpoint is the only one that does not require authentication with an account key. It is free to use for all and very powerful. It can check tens of thousands of mobiles in a fraction of a second

api/mobile/check

Checks for valid mobile in mobile parameter and returns a mobile object or error
Εnter any mobile below and click the "test it" button to get a quick glimpse on the API

https://premium-sms.gr/api/mobile/check

Accepts

Parameter	Value	Description
`mobile`	Mobile	Any string to check. Note that it will strip away all non numeric characters, so all characters except numbers will be ignored. [Required]
`type`		Format of the returned result. Can be either plain text (v2), `json` or `xml`. Default is `json`

Returns

Value	Description
`mobile{` `msisdn` `national` `country` `countryCode` `gsmCode` `number` `mcc` `mnc` `cost` `}`	Mobile object Mobile (international format) Mobile (national format) Country prefix Network prefix Number of mobile Mobile country code Mobile network code Cost to send 1 sms
`status`	The status of the call. Always `1` on success or `0` on error
`error`	Error code, `0` for no error otherwise check the list of error codes or the `remarks` parameter
`remarks`	Notes on the call. Always `Success` or error description

Errors

Error	Description
`201`	Failed to parse `mobile` to MSISDN (international format mobile number)Reproduce
`205`	`mobile` parameter is emptyReproduce

<?php

  $endpoint = 'https:///mobile/check';

  $parameters = array(
      'mobile'    => '306971234567',// mobile to check

      'type'      => 'json' // type of return format

      'type'      => 'xml'  // type of return format

      'type'      => 'v2'   // type of return format

);

  function call_endpoint($endpoint, $parameters){
      $c = curl_init();
      curl_setopt($c, CURLOPT_URL, $endpoint);
      curl_setopt($c, CURLOPT_POST, true);
      curl_setopt($c, CURLOPT_POSTFIELDS, $parameters);
      curl_setopt($c, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($c, CURLOPT_SSL_VERIFYPEER, false);
      $output =  curl_exec($c);
      curl_close($c);
      return $output;
  }

  $json = json_decode(call_endpoint($endpoint, $parameters), true);


  echo '<pre>';

  print_r($json);

  $xmldata = call_endpoint($endpoint, $parameters);


  if (function_exists('simplexml_load_string')){

    $xml = simplexml_load_string($xmldata);

  }else if (function_exists('xml_parser_create')){
    $xmlparser = xml_parser_create();
    xml_parse_into_struct($xmlparser, $xmldata, $xml);
    xml_parser_free($xmlparser);
  }

  echo '<pre>';

  print_r($xml);

  echo call_endpoint($endpoint, $parameters);

curl "https:///mobile/check?\
mobile=4412345678900"

api/key

Endpoint to get and reset the API key

api/key/get

Returns the API key of the account

https://premium-sms.gr/api/key/get

Accepts

Parameter	Value	Description
`username`	Username	Your username or email or mobile number. [Required] Existing API key [key=YOUR-KEY] can be used insted of [username-password] when you want to verify the key
`password`	Password	Account password. [Required]
`type`		Format of the returned result. Can be either plain text (v2), `json` or `xml`. Default is `json`

Returns

Value	Description
`key`	API key to use with all endpoints
`status`	The status of the call. Always `1` on success or `0` on error
`error`	Error code, `0` for no error otherwise check the list of error codes or the `remarks` parameter
`remarks`	Notes on the call. Always `Success` or error description

Errors

Error	Description
`101`	Check your credentialsReproduce

<?php

  $endpoint = 'https:///key/get';

  $parameters = array(
      'username'  => 'YOUR USERNAME',
      'password'  => 'YOUR PASSWORD',

      'type'      => 'json' // type of return format

      'type'      => 'xml'  // type of return format

      'type'      => 'v2'   // type of return format

);

  function call_endpoint($endpoint, $parameters){
      $c = curl_init();
      curl_setopt($c, CURLOPT_URL, $endpoint);
      curl_setopt($c, CURLOPT_POST, true);
      curl_setopt($c, CURLOPT_POSTFIELDS, $parameters);
      curl_setopt($c, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($c, CURLOPT_SSL_VERIFYPEER, false);
      $output =  curl_exec($c);
      curl_close($c);
      return $output;
  }

  $json = json_decode(call_endpoint($endpoint, $parameters), true);


  echo '<pre>';

  print_r($json);

  $xmldata = call_endpoint($endpoint, $parameters);


  if (function_exists('simplexml_load_string')){

    $xml = simplexml_load_string($xmldata);

  }else if (function_exists('xml_parser_create')){
    $xmlparser = xml_parser_create();
    xml_parse_into_struct($xmlparser, $xmldata, $xml);
    xml_parser_free($xmlparser);
  }

  echo '<pre>';

  print_r($xml);

  echo call_endpoint($endpoint, $parameters);

curl "https:///key/get?\
username=USERNAME&\
password=PASSWORD&\
type=xml"

api/key/reset

Resets the API key of the account to a new one randomly generated. Can be used frequently for increased security

https://premium-sms.gr/api/key/reset

Accepts

Parameter	Value	Description
`username`	Username	Your username or email or mobile number. [Required] Existing API key [key=YOUR-KEY] can be used insted of [username-password]
`password`	Password	Account password. [Required]
`type`		Format of the returned result. Can be either plain text (v2), `json` or `xml`. Default is `json`

Returns

Value	Description
`key`	API key to use with all endpoints
`status`	The status of the call. Always `1` on success or `0` on error
`error`	Error code, `0` for no error otherwise check the list of error codes or the `remarks` parameter
`remarks`	Notes on the call. Always `Success` or error description

Errors

Error	Description
`101`	Check your credentialsReproduce

<?php

  $endpoint = 'https:///key/reset';

  $parameters = array(
      'username'  => 'YOUR USERNAME',
      'password'  => 'YOUR PASSWORD',

      'type'      => 'json' // type of return format

      'type'      => 'xml'  // type of return format

      'type'      => 'v2'   // type of return format

);

  function call_endpoint($endpoint, $parameters){
      $c = curl_init();
      curl_setopt($c, CURLOPT_URL, $endpoint);
      curl_setopt($c, CURLOPT_POST, true);
      curl_setopt($c, CURLOPT_POSTFIELDS, $parameters);
      curl_setopt($c, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($c, CURLOPT_SSL_VERIFYPEER, false);
      $output =  curl_exec($c);
      curl_close($c);
      return $output;
  }

  $json = json_decode(call_endpoint($endpoint, $parameters), true);


  echo '<pre>';

  print_r($json);

  $xmldata = call_endpoint($endpoint, $parameters);


  if (function_exists('simplexml_load_string')){

    $xml = simplexml_load_string($xmldata);

  }else if (function_exists('xml_parser_create')){
    $xmlparser = xml_parser_create();
    xml_parse_into_struct($xmlparser, $xmldata, $xml);
    xml_parser_free($xmlparser);
  }

  echo '<pre>';

  print_r($xml);

  echo call_endpoint($endpoint, $parameters);

curl "https:///key/reset?\
username=USERNAME&\
password=PASSWORD&\
type=xml"

api/sms

api/sms/bulk

Performs a bulk sms submission

https://premium-sms.gr/api/sms/bulk

Accepts

Parameter	Value	Description
`key`	API key	Account API key. [Required]
`to`	Mobiles separated with ,	Mobiles of recipients separated with comma ,[Required]
`text`	Text	Text of the sms to send. [Required]
`from`	From	Sender of the sms
`ucs`	Unicode	`true` for Unicode or `false` for GSM (default)
`flash`	Flash	`true` for flash sms or `false` for normal (default)
`timestamp`	Timestamp	Timestamp in Unix epoch format to schedule the submission. Scheduled sms can be canceled using the `api/sms/cancel` endpoint
`type`		Format of the returned result. Can be either plain text (v2), `json` or `xml`. Default is `json`

Returns

Value	Description
`id{` `value` `...` `}` `sms{` `smsId` `msisdn` `}` `...`	Array of id and sms objects
`accepted`	Total sms accepted for submission
`rejected`	Total rejected sms
`balance`	Balance of account
`status`	The status of the call. Always `1` on success or `0` on error
`error`	Error code, `0` for no error otherwise check the list of error codes or the `remarks` parameter
`remarks`	Notes on the call. Always `Success` or error description

Errors

Error	Description
`101`	Check your credentialsReproduce
`102`	Parameter `to` is empty
`103`	Invalid `to` parameter. The `api/mobile/check` endpoint will validate any mobile number
`104`	Parameter `text` is empty
`105`	Not enough balance

<?php

  $endpoint = 'https:///sms/bulk';

  $parameters = array(
      'key'     => 'YOUR API KEY',
      'text'    => 'Your message',
      'from'    => 'sender',
      'to'    => '306971000000,306980000000,49172000000',

      'type'    => 'json' // type of return format

      'type'    => 'xml'  // type of return format

      'type'    => 'v2'   // type of return format

);

  function call_endpoint($endpoint, $parameters){
      $c = curl_init();
      curl_setopt($c, CURLOPT_URL, $endpoint);
      curl_setopt($c, CURLOPT_POST, true);
      curl_setopt($c, CURLOPT_POSTFIELDS, $parameters);
      curl_setopt($c, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($c, CURLOPT_SSL_VERIFYPEER, false);
      $output =  curl_exec($c);
      curl_close($c);
      return $output;
  }

  $json = json_decode(call_endpoint($endpoint, $parameters), true);


  echo '<pre>';

  print_r($json);

  $xmldata = call_endpoint($endpoint, $parameters);


  if (function_exists('simplexml_load_string')){

    $xml = simplexml_load_string($xmldata);

  }else if (function_exists('xml_parser_create')){
    $xmlparser = xml_parser_create();
    xml_parse_into_struct($xmlparser, $xmldata, $xml);
    xml_parser_free($xmlparser);
  }

  echo '<pre>';

  print_r($xml);

  echo call_endpoint($endpoint, $parameters);

curl "https:///sms/bulk?\
key=YOUR-API-KEY&\
text=your_message&\
from=sender&\
to=306971000000,306980000000,49172000000&\
type=xml"

api/sms/cancel

Cancels a scheduled sms. You can schedule any sms to be send in the future using the timestamp parameter of api/sms/send or similar endpoint

https://premium-sms.gr/api/sms/cancel

Accepts

Parameter	Value	Description
`key`	API key	Account API key. [Required]
`smsId`	smsId	The `smsId` you want to cancel. [Required]
`type`		Format of the returned result. Can be either plain text (v2), `json` or `xml`. Default is `json`

Returns

Value	Description
`smsId`	Deleted `smsId`
`status`	The status of the call. Always `1` on success or `0` on error
`error`	Error code, `0` for no error otherwise check the list of error codes or the `remarks` parameter
`remarks`	Notes on the call. Always `Success` or error description

Errors

Error	Description
`101`	Check your credentialsReproduce
`107`	`smsId` parameter is empty
`108`	Invalid `smsId` parameter
`109`	Message not found
`110`	Message already sent
`111`	Message could not be deleted

<?php

  $endpoint = 'https:///sms/cancel';

  $parameters = array(
      'key'     => 'YOUR API KEY',
      'smsId'   => 'SMS ID',

      'type'    => 'json' // type of return format

      'type'    => 'xml'  // type of return format

      'type'    => 'v2'   // type of return format

);

  function call_endpoint($endpoint, $parameters){
      $c = curl_init();
      curl_setopt($c, CURLOPT_URL, $endpoint);
      curl_setopt($c, CURLOPT_POST, true);
      curl_setopt($c, CURLOPT_POSTFIELDS, $parameters);
      curl_setopt($c, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($c, CURLOPT_SSL_VERIFYPEER, false);
      $output =  curl_exec($c);
      curl_close($c);
      return $output;
  }

  $json = json_decode(call_endpoint($endpoint, $parameters), true);


  echo '<pre>';

  print_r($json);

  $xmldata = call_endpoint($endpoint, $parameters);


  if (function_exists('simplexml_load_string')){

    $xml = simplexml_load_string($xmldata);

  }else if (function_exists('xml_parser_create')){
    $xmlparser = xml_parser_create();
    xml_parse_into_struct($xmlparser, $xmldata, $xml);
    xml_parser_free($xmlparser);
  }

  echo '<pre>';

  print_r($xml);

  echo call_endpoint($endpoint, $parameters);

curl "https:///sms/cancel?\
key=YOUR-API-KEY&\
smsId=SMSID&\
type=xml"

api/sms/send

Most popular endpoint. Sends or schedules a new sms of highest priority

https://premium-sms.gr/api/sms/send

Accepts

Parameter	Value	Description
`key`	API key	Account API key. [Required]
`to`	Mobile	Mobile of recipent. [Required]
`text`	Text	Text of the sms to send
`from`	From	Sender of the sms
`ucs`	Unicode	`true` for Unicode or `false` for GSM (default)
`flash`	Flash	`true` for flash sms or `false` for normal (default)
`timestamp`	Timestamp	Timestamp in Unix epoch format to schedule the submission. Scheduled sms can be canceled using the `api/sms/cancel` endpoint
`callback`	URL	Callback URL that will be called for delivery reports in real time. eg. `http://myserver.com/callback?id=yourmsgid` Few parameters will be appended to the URL using GET method: `msgid, status, cost, to, mcc, mnc` representing respectively: id of message, status (d or f) for delivered or failed, message cost, mobile number and network information. The use of the callback parameter is highly encourages since it is way more efficient than polling for message statuses via `api/status` endpoints The URL must be urlencoded()
`type`		Format of the returned result. Can be either plain text (v2), `json` or `xml`. Default is `json`

Returns

Value	Description
`smsId`	`smsId` of sms
`cost`	Cost of SMS
`balance`	Balance of account
`mcc`	Country code
`mnc`	Network code
`status`	The status of the call. Always `1` on success or `0` on error
`error`	Error code, `0` for no error otherwise check the list of error codes or the `remarks` parameter
`remarks`	Notes on the call. Always `Success` or error description

Errors

Error	Description
`101`	Check your credentialsReproduce
`102`	Parameter `to` is empty
`103`	Invalid `to` parameter. The `api/mobile/check` endpoint will validate any mobile number
`104`	Parameter `text` is empty
`105`	Not enough balance
`106`	Failed to queue the message

<?php

  $endpoint = 'https:///sms/send';

  $parameters = array(
      'key'     => 'YOUR API KEY',
      'text'    => 'Your message',
      'from'    => 'sender',
      'to'      => '306971000000',

      'type'    => 'json' // type of return format

      'type'    => 'xml'  // type of return format

      'type'    => 'v2'   // type of return format

);

  function call_endpoint($endpoint, $parameters){
      $c = curl_init();
      curl_setopt($c, CURLOPT_URL, $endpoint);
      curl_setopt($c, CURLOPT_POST, true);
      curl_setopt($c, CURLOPT_POSTFIELDS, $parameters);
      curl_setopt($c, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($c, CURLOPT_SSL_VERIFYPEER, false);
      $output =  curl_exec($c);
      curl_close($c);
      return $output;
  }

  $json = json_decode(call_endpoint($endpoint, $parameters), true);


  echo '<pre>';

  print_r($json);

  $xmldata = call_endpoint($endpoint, $parameters);


  if (function_exists('simplexml_load_string')){

    $xml = simplexml_load_string($xmldata);

  }else if (function_exists('xml_parser_create')){
    $xmlparser = xml_parser_create();
    xml_parse_into_struct($xmlparser, $xmldata, $xml);
    xml_parser_free($xmlparser);
  }

  echo '<pre>';

  print_r($xml);

  echo call_endpoint($endpoint, $parameters);

curl "https:///sms/send?\
key=YOUR-API-KEY&\
text=your_message&\
from=sender&\
to=306971000000&\
type=xml"

api/viber

Endpoints to send a Viber message and get the balance of the account

api/viber/send

Sends a Viber message with the option to fall-back to sms (if the Viber message fails)

https://premium-sms.gr/api/viber/send

Accepts

Parameter	Value	Description
`key`	API key	Account API key. [Required]
`to`	Mobile	Mobile of recipent. [Required]
`text`	Text	Text of the viber to send
`from`	From	Sender-id of the viber message. You need to apply for your own Sender-id and get approved by Viber.
`button_caption`	Button Caption	The caption of the button
`button_action`	Button Action	The redirect URL of the button
`image`	Image URL	The URL of the image. Must be 350px x 350px.
`validity`	Validity seconds	In seconds (60 to 86400 for 24 hours) the validity of the Viber message. After that the fall-back SMS is send. Default value is 86400 for 24 hours
`all_devices`	All	`true` to send to Smartphones and Tablets and `false` for Smartphones only
`sms_fallback`	SMS Fallback	`true` to send Fallback SMS if the Viber message fails to deliver
`sms_text`	SMS Text	Text of the fall-back sms
`sms_from`	Text	The originator of the fall-back sms
`ucs`	Unicode	For fall-back SMS: `true` for Unicode or `false` for GSM (default)
`flash`	Flash	For fall-back SMS: `true` for flash viber or `false` for normal (default)
`type`		Format of the returned result. Can be either plain text (v2), `json` or `xml`. Default is `json`

Returns

Value	Description
`id`	The id of the Viber message
`cost`	The cost of the Viber message
`balance`	The balance of the account
`status`	The status of the call. Always `1` on success or `0` on error
`error`	Error code, `0` for no error otherwise check the list of error codes or the `remarks` parameter
`remarks`	Notes on the call. Always `Success` or error description

Errors

Error	Description
`101`	Check your credentials
`501`	Missing `to`, `contactId` or `groupId` parameters
`503`	Paramater `from` is not authorized. You can apply for authorization by Viber.
`504`	The sender-id is paused. Contact us to activate it again.
`505`	Missing text for Viber message. Buttons must follow a text
`506`	Viber message text can be up to 1000 characters long
`507`	Missing `button_caption` parameter for the caption of the button
`508`	Missing `button_action` parameter
`509`	Missing `image` parameter
`510`	Invalid `all_devices` parameter
`511`	Messages with image and text need also a button
`512`	Messages without text can only have an image
`513`	Invalid `validity` parameter. Valid range is from 30 (minutes) to 1440 (minutes = 24 hours)
`514`	Invalid parameter `sms_from` for fall-back sms.
`515`	Invalid parameter `contactId`
`516`	Invalid parameter `groupId`
`517`	Account run out of balance
`518`	Message failed

<?php

  $endpoint = 'https:///viber/send';

  $parameters = array(
      'key'     => 'YOUR API KEY',
      'text'    => 'Your Viber message',
      'from'    => 'sender',
      'to'      => '306971000000',
      'button_caption' => 'BUTTON',
      'button_action'  => 'YOUR-URL',
      'image'          => 'IMAGE-URL',
      'validity'       => '600',
      'sms_fallback'   => true,
      'sms_from'       => 'ORIGINATOR',
      'sms_text'       => 'Your sms message',

      'type'    => 'json' // type of return format

      'type'    => 'xml'  // type of return format

      'type'    => 'v2'   // type of return format

);

  function call_endpoint($endpoint, $parameters){
      $c = curl_init();
      curl_setopt($c, CURLOPT_URL, $endpoint);
      curl_setopt($c, CURLOPT_POST, true);
      curl_setopt($c, CURLOPT_POSTFIELDS, $parameters);
      curl_setopt($c, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($c, CURLOPT_SSL_VERIFYPEER, false);
      $output =  curl_exec($c);
      curl_close($c);
      return $output;
  }

  $json = json_decode(call_endpoint($endpoint, $parameters), true);


  echo '<pre>';

  print_r($json);

  $xmldata = call_endpoint($endpoint, $parameters);


  if (function_exists('simplexml_load_string')){

    $xml = simplexml_load_string($xmldata);

  }else if (function_exists('xml_parser_create')){
    $xmlparser = xml_parser_create();
    xml_parse_into_struct($xmlparser, $xmldata, $xml);
    xml_parser_free($xmlparser);
  }

  echo '<pre>';

  print_r($xml);

  echo call_endpoint($endpoint, $parameters);

curl "https:///viber/send?\
key=YOUR-API-KEY&\
text=your_viber_message&\
from=sender&\
to=306971000000&\
button_caption=BUTTON&\
button_action=YOUR-URL&\
image=IMAGE-URL&\
validity=600&\
sms_fallback=true&\
sms_from=ORIGINATOR&\
sms_text=your_sms_message&\
type=xml"

api/viber/bulk

Sends Viber messages to multiple destinations with the option to fall-back to sms (if the Viber message fails)

https://premium-sms.gr/api/viber/bulk

Accepts

Parameter	Value	Description
`key`	API key	Account API key. [Required]
`to`	Mobiles separated with ,	Mobiles of recipients separated with comma , [Required]
`text`	Text	Text of the viber message
`from`	From	Sender-id of the viber message. You need to apply for your own Sender-id and get approved by Viber.
`button_caption`	Button Caption	The caption of the button
`button_action`	Button Action	The redirect URL of the button
`image`	Image URL	The URL of the image. Must be 350px x 350px.
`validity`	Validity seconds	In seconds (60 to 86400 for 24 hours) the validity of the Viber message. After that the fall-back SMS is bulk. Default value is 86400 for 24 hours
`all_devices`	All	`true` to send to Smartphones and Tablets and `false` for Smartphones only
`sms_fallback`	SMS Fallback	`true` to send Fallback SMS if the Viber message fails to deliver
`sms_text`	SMS Text	Text of the fall-back sms
`sms_from`	Text	The originator of the fall-back sms
`ucs`	Unicode	For fall-back SMS: `true` for Unicode or `false` for GSM (default)
`flash`	Flash	For fall-back SMS: `true` for flash viber or `false` for normal (default)
`type`		Format of the returned result. Can be either plain text (v2), `json` or `xml`. Default is `json`

Returns

Value	Description
`id{` `value` `...` `}` `messages{` `id` `msisdn` `cost` `}` `...`	Array of id and message objects
`accepted`	Total messages accepted for submission
`rejected`	Total messages rejected
`balance`	Balance of account
`status`	The status of the call. Always `1` on success or `0` on error
`error`	Error code, `0` for no error otherwise check the list of error codes or the `remarks` parameter
`remarks`	Notes on the call. Always `Success` or error description

Errors

Error	Description
`101`	Check your credentials
`501`	Missing `to`, `contactId` or `groupId` parameters
`503`	Paramater `from` is not authorized. You can apply for authorization by Viber.
`504`	The sender-id is paused. Contact us to activate it again.
`505`	Missing text for Viber message. Buttons must follow a text
`506`	Viber message text can be up to 1000 characters long
`507`	Missing `button_caption` parameter for the caption of the button
`508`	Missing `button_action` parameter
`509`	Missing `image` parameter
`510`	Invalid `all_devices` parameter
`511`	Messages with image and text need also a button
`512`	Messages without text can only have an image
`513`	Invalid `validity` parameter. Valid range is from 30 (minutes) to 1440 (minutes = 24 hours)
`514`	Invalid parameter `sms_from` for fall-back sms.
`515`	Invalid parameter `contactId`
`516`	Invalid parameter `groupId`
`517`	Account run out of balance
`518`	Message failed

<?php

  $endpoint = 'https:///viber/bulk';

  $parameters = array(
      'key'     => 'YOUR API KEY',
      'text'    => 'Your Viber message',
      'from'    => 'sender',
      'to'      => '306971000000,306940000000,491725984200',
      'button_caption' => 'BUTTON',
      'button_action'  => 'YOUR-URL',
      'image'          => 'IMAGE-URL',
      'validity'       => '600',
      'sms_fallback'   => true,
      'sms_from'       => 'ORIGINATOR',
      'sms_text'       => 'Your sms message',

      'type'    => 'json' // type of return format

      'type'    => 'xml'  // type of return format

      'type'    => 'v2'   // type of return format

);

  function call_endpoint($endpoint, $parameters){
      $c = curl_init();
      curl_setopt($c, CURLOPT_URL, $endpoint);
      curl_setopt($c, CURLOPT_POST, true);
      curl_setopt($c, CURLOPT_POSTFIELDS, $parameters);
      curl_setopt($c, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($c, CURLOPT_SSL_VERIFYPEER, false);
      $output =  curl_exec($c);
      curl_close($c);
      return $output;
  }

  $json = json_decode(call_endpoint($endpoint, $parameters), true);


  echo '<pre>';

  print_r($json);

  $xmldata = call_endpoint($endpoint, $parameters);


  if (function_exists('simplexml_load_string')){

    $xml = simplexml_load_string($xmldata);

  }else if (function_exists('xml_parser_create')){
    $xmlparser = xml_parser_create();
    xml_parse_into_struct($xmlparser, $xmldata, $xml);
    xml_parser_free($xmlparser);
  }

  echo '<pre>';

  print_r($xml);

  echo call_endpoint($endpoint, $parameters);

curl "https:///viber/bulk?\
key=YOUR-API-KEY&\
text=your_viber_message&\
from=sender&\
to=306971000000,306940000000,491725984200&\
button_caption=BUTTON&\
button_action=YOUR-URL&\
image=IMAGE-URL&\
validity=600&\
sms_fallback=true&\
sms_from=ORIGINATOR&\
sms_text=your_sms_message&\
type=xml"

api/viber/balance

It returns a list of the sender ids approved by Viber and the balance of each one

https://premium-sms.gr/api/viber/balance

Accepts

Parameter	Value	Description
`key`	API key	Account API key. [Required]
`type`		Format of the returned result. Can be either plain text (v2), `json` or `xml`. Default is `json`

Returns

Value	Description
`senders{` `sender{` `senderId` `text` `balance` `twoway` `paused` `}` `}`	Senders object for the sender-ids approved by Viber. Each account can handle more than 1 senders
`status`	The status of the call. Always `1` on success or `0` on error
`error`	Error code, `0` for no error otherwise check the list of error codes or the `remarks` parameter
`remarks`	Notes on the call. Always `Success` or error description

Errors

Error	Description
`101`	Check your credentialsReproduce

<?php

  $endpoint = 'https:///viber/balance';

  $parameters = array(
      'key'     => 'YOUR API KEY',

      'type'    => 'json' // type of return format

      'type'    => 'xml'  // type of return format

      'type'    => 'v2'   // type of return format

);

  function call_endpoint($endpoint, $parameters){
      $c = curl_init();
      curl_setopt($c, CURLOPT_URL, $endpoint);
      curl_setopt($c, CURLOPT_POST, true);
      curl_setopt($c, CURLOPT_POSTFIELDS, $parameters);
      curl_setopt($c, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($c, CURLOPT_SSL_VERIFYPEER, false);
      $output =  curl_exec($c);
      curl_close($c);
      return $output;
  }

  $json = json_decode(call_endpoint($endpoint, $parameters), true);


  echo '<pre>';

  print_r($json);

  $xmldata = call_endpoint($endpoint, $parameters);


  if (function_exists('simplexml_load_string')){

    $xml = simplexml_load_string($xmldata);

  }else if (function_exists('xml_parser_create')){
    $xmlparser = xml_parser_create();
    xml_parse_into_struct($xmlparser, $xmldata, $xml);
    xml_parser_free($xmlparser);
  }

  echo '<pre>';

  print_r($xml);

  echo call_endpoint($endpoint, $parameters);

curl "https:///viber/balance?\
key=YOUR-API-KEY&\
type=xml"

api/me

Account management endpoints

api/me/balance

Returns the balance of the account

Alias of api/balance/get (older API v.2)

https://premium-sms.gr/api/me/balance

Accepts

Parameter	Value	Description
`key`	API key	Account API key. [Required]
`type`		Format of the returned result. Can be either plain text (v2), `json` or `xml`. Default is `json`

Returns

Value	Description
`balance`	Account balance
`status`	The status of the call. Always `1` on success or `0` on error
`error`	Error code, `0` for no error otherwise check the list of error codes or the `remarks` parameter
`remarks`	Notes on the call. Always `Success` or error description

Errors

Error	Description
`101`	Check your credentials

<?php

  $endpoint = 'https:///me/balance';

  $parameters = array(
      'key'       => 'YOUR API KEY',

      'type'      => 'json' // type of return format

      'type'      => 'xml'  // type of return format

      'type'      => 'v2'   // type of return format

);

  function call_endpoint($endpoint, $parameters){
      $c = curl_init();
      curl_setopt($c, CURLOPT_URL, $endpoint);
      curl_setopt($c, CURLOPT_POST, true);
      curl_setopt($c, CURLOPT_POSTFIELDS, $parameters);
      curl_setopt($c, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($c, CURLOPT_SSL_VERIFYPEER, false);
      $output =  curl_exec($c);
      curl_close($c);
      return $output;
  }

  $json = json_decode(call_endpoint($endpoint, $parameters), true);


  echo '<pre>';

  print_r($json);

  $xmldata = call_endpoint($endpoint, $parameters);


  if (function_exists('simplexml_load_string')){

    $xml = simplexml_load_string($xmldata);

  }else if (function_exists('xml_parser_create')){
    $xmlparser = xml_parser_create();
    xml_parse_into_struct($xmlparser, $xmldata, $xml);
    xml_parser_free($xmlparser);
  }

  echo '<pre>';

  print_r($xml);

  echo call_endpoint($endpoint, $parameters);

curl "https:///me/balance?\
key=YOUR-API-KEY&\
type=xml"

api/2fa

Endpoints to send and check a 2-Factor Authentication code.

It is the same authentication methods banks are using world-wide based on the principal:

a. Something you know (username, password) and
b. Something you have (mobile)

api/2fa/send

Sends an authentication code by SMS and returns the status of that message (d for delivered, f for failed to deliver or s if no delivery report yet).

With the wait parameter you set the maximum time (in seconds) for the call to wait for delivery report.

Using the callback parameter you set the URL to be called in real time as soon as the delivery report arrives.

If both wait and callback paramters are missing then the call will wait for 10 seconds by default for the delivery report.
If the callback parameter is set, or the wait parameter is 0, the call will return immediately and if callback is set it will be called as soon as the delivery report arrives.

https://premium-sms.gr/api/2fa/send

Accepts

Parameter	Value	Description
`key`	API key	Account API key. [Required]
`to`	Mobile	Mobile of recipent. [Required]
`text`	Text	Text of the 2fa to send. If it contains the string %%CODE%% then this string will be replaced with a random 4-digit number
`from`	From	Sender of the 2fa
`wait`	Seconds	Seconds to wait for delivery report
`callback`	URL	Delivery report URL
`ucs`	Unicode	`true` for Unicode or `false` for GSM (default)
`type`		Format of the returned result. Can be either plain text (v2), `json` or `xml`. Default is `json`

Returns

Value	Description
`authId`	Unique id for each authentication and input parameter for the call `2fa/check`
`authStatus`	The status of the authentication message. It can be `d` delivered, `f` failed or `s` sent, delivery report is still pending
`status`	The status of the call. Always `1` on success or `0` on error
`error`	Error code, `0` for no error otherwise check the list of error codes or the `remarks` parameter
`remarks`	Notes on the call. Always `Success` or error description

Errors

Error	Description
`101`	Check your credentialsReproduce
`102`	Parameter `to` is empty
`103`	Invalid `to` parameter. The `api/mobile/check` endpoint will validate any mobile number
`105`	Not enough balance
`106`	Failed to queue the message

<?php

  $endpoint = 'https:///2fa/send';

  $parameters = array(
      'key'     => 'YOUR API KEY',
      'to'      => '306971000000',

      'type'    => 'json' // type of return format

      'type'    => 'xml'  // type of return format

      'type'    => 'v2'   // type of return format

);

  function call_endpoint($endpoint, $parameters){
      $c = curl_init();
      curl_setopt($c, CURLOPT_URL, $endpoint);
      curl_setopt($c, CURLOPT_POST, true);
      curl_setopt($c, CURLOPT_POSTFIELDS, $parameters);
      curl_setopt($c, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($c, CURLOPT_SSL_VERIFYPEER, false);
      $output =  curl_exec($c);
      curl_close($c);
      return $output;
  }

  $json = json_decode(call_endpoint($endpoint, $parameters), true);


  echo '<pre>';

  print_r($json);

  $xmldata = call_endpoint($endpoint, $parameters);


  if (function_exists('simplexml_load_string')){

    $xml = simplexml_load_string($xmldata);

  }else if (function_exists('xml_parser_create')){
    $xmlparser = xml_parser_create();
    xml_parse_into_struct($xmlparser, $xmldata, $xml);
    xml_parser_free($xmlparser);
  }

  echo '<pre>';

  print_r($xml);

  echo call_endpoint($endpoint, $parameters);

curl "https:///2fa/send?\
key=YOUR-API-KEY&\
to=306971000000&\
type=xml"

api/2fa/check

Checks if the parameter code is the right authentication code and returns ok if it is or nok if not.

https://premium-sms.gr/api/2fa/check

Accepts

Parameter	Value	Description
`key`	API key	Account API key. [Required]
`authId`	authId	The authentication message id returned from `2fa/send`. [Required]
`code`	Code	Authentication code to check if valid. [Required]
`type`		Format of the returned result. Can be either plain text (v2), `json` or `xml`. Default is `json`

Returns

Value	Description
`auth`	`ok` if authenticated or `nok` if not
`status`	The status of the call. Always `1` on success or `0` on error
`error`	Error code, `0` for no error otherwise check the list of error codes or the `remarks` parameter
`remarks`	Notes on the call. Always `Success` or error description

Errors

Error	Description
`101`	Check your credentialsReproduce
`300`	There is no `authId` parameter
`301`	There is no `code` parameter
`302`	No authentication message found for `authId`

<?php

  $endpoint = 'https:///2fa/check';

  $parameters = array(
      'key'     => 'YOUR API KEY',
      'authId'  => 'AUTH ID' ,
      'code'    => 'USER INPUT',

      'type'    => 'json' // type of return format

      'type'    => 'xml'  // type of return format

      'type'    => 'v2'   // type of return format

);

  function call_endpoint($endpoint, $parameters){
      $c = curl_init();
      curl_setopt($c, CURLOPT_URL, $endpoint);
      curl_setopt($c, CURLOPT_POST, true);
      curl_setopt($c, CURLOPT_POSTFIELDS, $parameters);
      curl_setopt($c, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($c, CURLOPT_SSL_VERIFYPEER, false);
      $output =  curl_exec($c);
      curl_close($c);
      return $output;
  }

  $json = json_decode(call_endpoint($endpoint, $parameters), true);


  echo '<pre>';

  print_r($json);

  $xmldata = call_endpoint($endpoint, $parameters);


  if (function_exists('simplexml_load_string')){

    $xml = simplexml_load_string($xmldata);

  }else if (function_exists('xml_parser_create')){
    $xmlparser = xml_parser_create();
    xml_parse_into_struct($xmlparser, $xmldata, $xml);
    xml_parser_free($xmlparser);
  }

  echo '<pre>';

  print_r($xml);

  echo call_endpoint($endpoint, $parameters);

curl "https:///2fa/check?\
key=YOUR-API-KEY&\
authId=AUTH ID&\
code=USER INPUT&\
type=xml"

api/contact

The api/contact/* calls allow your applications to fully manipulate the contacts of your account and those of your sub-users accounts.

api/contact/add

Adds a new contact to your contact list and returns the contactId of the inserted contact. To add this contact to a group you need to subsequently call the api/group/addContact endpoint

https://premium-sms.gr/api/contact/add

Accepts

Parameter	Value	Description
`key`	API key	Account API key. [Required]
`mobile`	Mobile	The mobile number of the contact. The mobile parser can efficiently parse almost any user input to mobile number. [Required]
`name`	Name	First name of contact
`surname`	Surname	Last name of contact
`fullname`	Fullname	Full name of contact
`vname`	Name voc.	First name in vocative. Useful for personalised messages
`vsurname`	Surname voc.	Last name in vocative. Useful for personalised messages
`birthday`	Birthday	Birthday of contact in `YYYY-MM-DD` format
`nameday`	Nameday	Nameday of contact in `YYYY-MM-DD` format
`custom1`	Custom 1	Custom field 1. You may enter any data
`custom1`	Custom 2	Custom field 2. You may enter any data
`custom1`	Custom 3	Custom field 3. You may enter any data
`custom1`	Custom 4	Custom field 4. You may enter any data
`custom1`	Custom 5	Custom field 5. You may enter any data
`type`		Format of the returned result. Can be either plain text (v2), `json` or `xml`. Default is `json`

Returns

Value	Description
`contactId`	The `contactId` of the new contact
`status`	The status of the call. Always `1` on success or `0` on error
`error`	Error code, `0` for no error otherwise check the list of error codes or the `remarks` parameter
`remarks`	Notes on the call. Always `Success` or error description

Errors

Error	Description
`101`	Check your credentialsReproduce
`201`	Failed to parse `mobile` to MSISDN (international format mobile number)
`202`	`mobile` is already associated with another contact
`203`	`mobile` is in your Opt-Out list
`204`	Could not insert contact
`205`	No `mobile` parameter

<?php

  $endpoint = 'https:///contact/add';

  $parameters = array(
      'key'       => 'YOUR API KEY',
      'mobile'    => '44123456789',
      'name'      => 'Joe',
      'surname'   => 'Doe',

      'type'      => 'json' // type of return format

      'type'      => 'xml'  // type of return format

      'type'      => 'v2'   // type of return format

);

  function call_endpoint($endpoint, $parameters){
      $c = curl_init();
      curl_setopt($c, CURLOPT_URL, $endpoint);
      curl_setopt($c, CURLOPT_POST, true);
      curl_setopt($c, CURLOPT_POSTFIELDS, $parameters);
      curl_setopt($c, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($c, CURLOPT_SSL_VERIFYPEER, false);
      $output =  curl_exec($c);
      curl_close($c);
      return $output;
  }

  $json = json_decode(call_endpoint($endpoint, $parameters), true);


  echo '<pre>';

  print_r($json);

  $xmldata = call_endpoint($endpoint, $parameters);


  if (function_exists('simplexml_load_string')){

    $xml = simplexml_load_string($xmldata);

  }else if (function_exists('xml_parser_create')){
    $xmlparser = xml_parser_create();
    xml_parse_into_struct($xmlparser, $xmldata, $xml);
    xml_parser_free($xmlparser);
  }

  echo '<pre>';

  print_r($xml);

  echo call_endpoint($endpoint, $parameters);

curl "https:///contact/add?\
key=YOUR-API-KEY&\
mobile=44123456789&\
name=Joe&\
surname=Doe&\
type=xml"

api/contact/delete

Deletes contact from your contact list and all associations of the contact with groups

https://premium-sms.gr/api/contact/delete

Accepts

Parameter	Value	Description
`key`	API key	Account API key. [Required]
`contactId`	contactId	The `contactId` of the contact you want to delete. A list of all account contacts is returned from api/contact/list call. [Required]
`type`		Format of the returned result. Can be either plain text (v2), `json` or `xml`. Default is `json`

Returns

Value	Description
`status`	The status of the call. Always `1` on success or `0` on error
`error`	Error code, `0` for no error otherwise check the list of error codes or the `remarks` parameter
`remarks`	Notes on the call. Always `Success` or error description

Errors

Error	Description
`101`	Check your credentialsReproduce
`214`	`contacId` parameter is missing
`216`	`contactId` not found in contact list

<?php

  $endpoint = 'https:///contact/delete';

  $parameters = array(
      'key'       => 'YOUR API KEY',
      'contactId' => 'CONTACT-ID',

      'type'      => 'json' // type of return format

      'type'      => 'xml'  // type of return format

      'type'      => 'v2'   // type of return format

);

  function call_endpoint($endpoint, $parameters){
      $c = curl_init();
      curl_setopt($c, CURLOPT_URL, $endpoint);
      curl_setopt($c, CURLOPT_POST, true);
      curl_setopt($c, CURLOPT_POSTFIELDS, $parameters);
      curl_setopt($c, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($c, CURLOPT_SSL_VERIFYPEER, false);
      $output =  curl_exec($c);
      curl_close($c);
      return $output;
  }

  $json = json_decode(call_endpoint($endpoint, $parameters), true);


  echo '<pre>';

  print_r($json);

  $xmldata = call_endpoint($endpoint, $parameters);


  if (function_exists('simplexml_load_string')){

    $xml = simplexml_load_string($xmldata);

  }else if (function_exists('xml_parser_create')){
    $xmlparser = xml_parser_create();
    xml_parse_into_struct($xmlparser, $xmldata, $xml);
    xml_parser_free($xmlparser);
  }

  echo '<pre>';

  print_r($xml);

  echo call_endpoint($endpoint, $parameters);

curl "https:///contact/delete?\
key=YOUR-API-KEY&\
contactId=CONTACT-ID&\
type=xml"

api/contact/get

Returns a contact from your contact list and all associated groups

https://premium-sms.gr/api/contact/get

Accepts

Parameter	Value	Description
`key`	API key	Account API key. [Required]
`contactId`	contactId	The `contactId` of the contact you want to get. A list of all account contacts is returned from api/contact/list call. [Required]
`type`		Format of the returned result. Can be either plain text (v2), `json` or `xml`. Default is `json`

Returns

Value	Description
`contact{` `contactId` `mobile` `name` `surname` `vname` `vsurname` `birthday` `nameday` `custom1` `custom2` `custom3` `custom4` `custom5` `groups{` `group{` `groupId` `name` `}` `}`	Contact object with associated group objects
`total`	Total records returned
`status`	The status of the call. Always `1` on success or `0` on error
`error`	Error code, `0` for no error otherwise check the list of error codes or the `remarks` parameter
`remarks`	Notes on the call. Always `Success` or error description

Errors

Error	Description
`101`	Check your credentialsReproduce
`214`	`contacId` parameter is missing
`216`	`contactId` not found in contact list

<?php

  $endpoint = 'https:///contact/get';

  $parameters = array(
      'key'       => 'YOUR API KEY',
      'contactId' => 'CONTACT-ID',

      'type'      => 'json' // type of return format

      'type'      => 'xml'  // type of return format

      'type'      => 'v2'   // type of return format

);

  function call_endpoint($endpoint, $parameters){
      $c = curl_init();
      curl_setopt($c, CURLOPT_URL, $endpoint);
      curl_setopt($c, CURLOPT_POST, true);
      curl_setopt($c, CURLOPT_POSTFIELDS, $parameters);
      curl_setopt($c, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($c, CURLOPT_SSL_VERIFYPEER, false);
      $output =  curl_exec($c);
      curl_close($c);
      return $output;
  }

  $json = json_decode(call_endpoint($endpoint, $parameters), true);


  echo '<pre>';

  print_r($json);

  $xmldata = call_endpoint($endpoint, $parameters);


  if (function_exists('simplexml_load_string')){

    $xml = simplexml_load_string($xmldata);

  }else if (function_exists('xml_parser_create')){
    $xmlparser = xml_parser_create();
    xml_parse_into_struct($xmlparser, $xmldata, $xml);
    xml_parser_free($xmlparser);
  }

  echo '<pre>';

  print_r($xml);

  echo call_endpoint($endpoint, $parameters);

curl "https:///contact/get?\
key=YOUR-API-KEY&\
contactId=CONTACT-ID&\
type=xml"

api/contact/list

Returns a contact list of all contacts

https://premium-sms.gr/api/contact/list

Accepts

Parameter	Value	Description
`key`	API key	Account API key. [Required]
`type`		Format of the returned result. Can be either plain text (v2), `json` or `xml`. Default is `json`

Returns

Value	Description
`contacts{` `contact{` `contactId` `name` `mobile` `cost` `surname` `vname` `vsurname` `birthday` `nameday` `custom1` `custom2` `custom3` `custom4` `custom5` `}` `}`	Array of contact objects
`total`	Total records returned
`status`	The status of the call. Always `1` on success or `0` on error
`error`	Error code, `0` for no error otherwise check the list of error codes or the `remarks` parameter
`remarks`	Notes on the call. Always `Success` or error description

Errors

Error	Description
`101`	Check your credentialsReproduce

<?php

  $endpoint = 'https:///contact/list';

  $parameters = array(
      'key'       => 'YOUR API KEY',

      'type'      => 'json' // type of return format

      'type'      => 'xml'  // type of return format

      'type'      => 'v2'   // type of return format

);

  function call_endpoint($endpoint, $parameters){
      $c = curl_init();
      curl_setopt($c, CURLOPT_URL, $endpoint);
      curl_setopt($c, CURLOPT_POST, true);
      curl_setopt($c, CURLOPT_POSTFIELDS, $parameters);
      curl_setopt($c, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($c, CURLOPT_SSL_VERIFYPEER, false);
      $output =  curl_exec($c);
      curl_close($c);
      return $output;
  }

  $json = json_decode(call_endpoint($endpoint, $parameters), true);


  echo '<pre>';

  print_r($json);

  $xmldata = call_endpoint($endpoint, $parameters);


  if (function_exists('simplexml_load_string')){

    $xml = simplexml_load_string($xmldata);

  }else if (function_exists('xml_parser_create')){
    $xmlparser = xml_parser_create();
    xml_parse_into_struct($xmlparser, $xmldata, $xml);
    xml_parser_free($xmlparser);
  }

  echo '<pre>';

  print_r($xml);

  echo call_endpoint($endpoint, $parameters);

curl "https:///contact/list?\
key=YOUR-API-KEY&\
type=xml"

api/contact/update

Updates a contact with new properties

https://premium-sms.gr/api/contact/update

Accepts

Parameter	Value	Description
`key`	API key	Account API key. [Required]
`contactId`	contactId	`contactId` to update. [Required]
`mobile`	Mobile	New mobile number of the contact
`name`	Name	First name of contact
`surname`	Surname	Last name of contact
`fullname`	Fullname	Full name of contact
`vname`	Name voc.	First name in vocative. Useful for personalised messages
`vsurname`	Surname voc.	Last name in vocative. Useful for personalised messages
`birthday`	Birthday	Birthday of contact in `YYYY-MM-DD` format
`nameday`	Nameday	Nameday of contact in `YYYY-MM-DD` format
`custom1`	Custom 1	Custom field 1. You may enter any data
`custom1`	Custom 2	Custom field 2. You may enter any data
`custom1`	Custom 3	Custom field 3. You may enter any data
`custom1`	Custom 4	Custom field 4. You may enter any data
`custom1`	Custom 5	Custom field 5. You may enter any data
`type`		Format of the returned result. Can be either plain text (v2), `json` or `xml`. Default is `json`

Returns

Value	Description
`contactId`	Id of the updated contact
`status`	The status of the call. Always `1` on success or `0` on error
`error`	Error code, `0` for no error otherwise check the list of error codes or the `remarks` parameter
`remarks`	Notes on the call. Always `Success` or error description

Errors

Error	Description
`101`	Check your credentialsReproduce
`201`	Failed to parse `mobile` to MSISDN (international format mobile number)
`202`	`mobile` is already associated with another contact
`203`	`mobile` is in your Opt-Out list
`214`	`contacId` parameter is missing
`221`	Could not update contact

<?php

  $endpoint = 'https:///contact/udpate';

  $parameters = array(
      'key'         => 'YOUR API KEY',
      'contactId'   => 'CONTACT-ID',
      'mobile'      => '44123456789',
      'name'        => 'Joe',
      'surname'     => 'Doe',

      'type'        => 'json' // type of return format

      'type'        => 'xml'  // type of return format

      'type'      => 'v2'   // type of return format

);

  function call_endpoint($endpoint, $parameters){
      $c = curl_init();
      curl_setopt($c, CURLOPT_URL, $endpoint);
      curl_setopt($c, CURLOPT_POST, true);
      curl_setopt($c, CURLOPT_POSTFIELDS, $parameters);
      curl_setopt($c, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($c, CURLOPT_SSL_VERIFYPEER, false);
      $output =  curl_exec($c);
      curl_close($c);
      return $output;
  }

  $json = json_decode(call_endpoint($endpoint, $parameters), true);


  echo '<pre>';

  print_r($json);

  $xmldata = call_endpoint($endpoint, $parameters);


  if (function_exists('simplexml_load_string')){

    $xml = simplexml_load_string($xmldata);

  }else if (function_exists('xml_parser_create')){
    $xmlparser = xml_parser_create();
    xml_parse_into_struct($xmlparser, $xmldata, $xml);
    xml_parser_free($xmlparser);
  }

  echo '<pre>';

  print_r($xml);

  echo call_endpoint($endpoint, $parameters);

curl "https:///contact/update?\
key=YOUR-API-KEY&\
contactId=CONTACT-ID&\
mobile=44123456789&\
name=Joe&\
surname=Doe&\
vname=Joe&\
vsurname=Doe&\
fullname=Joe-Doe&\
birthday=1980-12-24&\
nameday=1980-05-15&\
custom1=any-data-1\
custom2=any-data-2&\
custom3=any-data-3&\
custom4=any-data-4&\
custom5=any-data-5&\
type=xml"

api/group

The api/group/* calls allow your applications to fully manipulate the groups of your account and the groups of your sub-users accounts

api/group/add

Adds a new group to your group list and returns the groupId of the inserted group.
To add contacts to this group you need to subsequently call the api/group/addContact or equivalent endpoint

https://premium-sms.gr/api/group/add

Accepts

Parameter	Value	Description
`key`	API key	Account API key. [Required]
`name`	Name	Group name
`type`		Format of the returned result. Can be either plain text (v2), `json` or `xml`. Default is `json`

Returns

Value	Description
`groupId`	The `groupId` of the new group
`status`	The status of the call. Always `1` on success or `0` on error
`error`	Error code, `0` for no error otherwise check the list of error codes or the `remarks` parameter
`remarks`	Notes on the call. Always `Success` or error description

Errors

Error	Description
`101`	Check your credentials
`213`	The `name` parameter is missing

<?php

  $endpoint = 'https:///group/add';

  $parameters = array(
      'key'       => 'YOUR API KEY',
      'name'      => 'Group name',

      'type'      => 'json' // type of return format

      'type'      => 'xml'  // type of return format

      'type'      => 'v2'   // type of return format

);

  function call_endpoint($endpoint, $parameters){
      $c = curl_init();
      curl_setopt($c, CURLOPT_URL, $endpoint);
      curl_setopt($c, CURLOPT_POST, true);
      curl_setopt($c, CURLOPT_POSTFIELDS, $parameters);
      curl_setopt($c, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($c, CURLOPT_SSL_VERIFYPEER, false);
      $output =  curl_exec($c);
      curl_close($c);
      return $output;
  }

  $json = json_decode(call_endpoint($endpoint, $parameters), true);


  echo '<pre>';

  print_r($json);

  $xmldata = call_endpoint($endpoint, $parameters);


  if (function_exists('simplexml_load_string')){

    $xml = simplexml_load_string($xmldata);

  }else if (function_exists('xml_parser_create')){
    $xmlparser = xml_parser_create();
    xml_parse_into_struct($xmlparser, $xmldata, $xml);
    xml_parser_free($xmlparser);
  }

  echo '<pre>';

  print_r($xml);

  echo call_endpoint($endpoint, $parameters);

curl "https:///group/add?\
key=YOUR-API-KEY&\
name=Group-Name&\
type=xml"

api/group/addContact

Adds a reference of a contact to a group

https://premium-sms.gr/api/group/addContact

Accepts

Parameter	Value	Description
`key`	API key	Account API key. [Required]
`groupId`	groupId	The `groupId` of the group
`contactId`	contactId	The `contactId` of the contact to add to the group
`type`		Format of the returned result. Can be either plain text (v2), `json` or `xml`. Default is `json`

Returns

Value	Description
`contactGroupId`	Reference of the associated contact with the group
`status`	The status of the call. Always `1` on success or `0` on error
`error`	Error code, `0` for no error otherwise check the list of error codes or the `remarks` parameter
`remarks`	Notes on the call. Always `Success` or error description

Errors

Error	Description
`101`	Check your credentials
`214`	`contacId` parameter is missing
`215`	`groupId` parameter is missing
`216`	`contactId` not found in contact list
`217`	`groupId` not found in group list
`218`	`contactId` already in `groupId`. Can be interpreted as success :!)

<?php

  $endpoint = 'https:///group/addContact';

  $parameters = array(
      'key'       => 'YOUR API KEY',
      'groupId'   => 'GROUP-ID',
      'contactId' => 'CONTACT-ID',

      'type'      => 'json' // type of return format

      'type'      => 'xml'  // type of return format

      'type'      => 'v2'   // type of return format

);

  function call_endpoint($endpoint, $parameters){
      $c = curl_init();
      curl_setopt($c, CURLOPT_URL, $endpoint);
      curl_setopt($c, CURLOPT_POST, true);
      curl_setopt($c, CURLOPT_POSTFIELDS, $parameters);
      curl_setopt($c, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($c, CURLOPT_SSL_VERIFYPEER, false);
      $output =  curl_exec($c);
      curl_close($c);
      return $output;
  }

  $json = json_decode(call_endpoint($endpoint, $parameters), true);


  echo '<pre>';

  print_r($json);

  $xmldata = call_endpoint($endpoint, $parameters);


  if (function_exists('simplexml_load_string')){

    $xml = simplexml_load_string($xmldata);

  }else if (function_exists('xml_parser_create')){
    $xmlparser = xml_parser_create();
    xml_parse_into_struct($xmlparser, $xmldata, $xml);
    xml_parser_free($xmlparser);
  }

  echo '<pre>';

  print_r($xml);

  echo call_endpoint($endpoint, $parameters);

curl "https:///group/addContact?\
key=YOUR-API-KEY&\
groupId=GROUP-ID&\
contactId=CONTACT-ID&\
type=xml"

api/group/delete

Deletes a group and all associations with contacts for this group.
Note that the contacts of the group still remain in the contact list along with their references to other groups

https://premium-sms.gr/api/group/delete

Accepts

Parameter	Value	Description
`key`	API key	Account API key. [Required]
`groupId`	groupId	The `groupId` of the group you want to delete. A list of all groups is returned from api/group/list call. [Required]
`type`		Format of the returned result. Can be either plain text (v2), `json` or `xml`. Default is `json`

Returns

Value	Description
`status`	The status of the call. Always `1` on success or `0` on error
`error`	Error code, `0` for no error otherwise check the list of error codes or the `remarks` parameter
`remarks`	Notes on the call. Always `Success` or error description

Errors

Error	Description
`101`	Check your credentials
`215`	`groupId` parameter is missing
`217`	`groupId` not found in group list

<?php

  $endpoint = 'https:///group/delete';

  $parameters = array(
      'key'       => 'YOUR API KEY',
      'groupId'   => 'GROUP-ID',

      'type'      => 'json' // type of return format

      'type'      => 'xml'  // type of return format

      'type'      => 'v2'   // type of return format

);

  function call_endpoint($endpoint, $parameters){
      $c = curl_init();
      curl_setopt($c, CURLOPT_URL, $endpoint);
      curl_setopt($c, CURLOPT_POST, true);
      curl_setopt($c, CURLOPT_POSTFIELDS, $parameters);
      curl_setopt($c, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($c, CURLOPT_SSL_VERIFYPEER, false);
      $output =  curl_exec($c);
      curl_close($c);
      return $output;
  }

  $json = json_decode(call_endpoint($endpoint, $parameters), true);


  echo '<pre>';

  print_r($json);

  $xmldata = call_endpoint($endpoint, $parameters);


  if (function_exists('simplexml_load_string')){

    $xml = simplexml_load_string($xmldata);

  }else if (function_exists('xml_parser_create')){
    $xmlparser = xml_parser_create();
    xml_parse_into_struct($xmlparser, $xmldata, $xml);
    xml_parser_free($xmlparser);
  }

  echo '<pre>';

  print_r($xml);

  echo call_endpoint($endpoint, $parameters);

curl "https:///group/delete?\
key=YOUR-API-KEY&\
groupId=GROUP-ID&\
type=xml"

api/group/deleteAllContacts

Deletes all contact references from a group.
Note that the contacts of the group still remain in the contact list

https://premium-sms.gr/api/group/deleteAllContacts

Accepts

Parameter	Value	Description
`key`	API key	Account API key. [Required]
`groupId`	groupId	The `groupId` of the group you want to delete. A list of all groups is returned from api/group/list call. [Required]
`type`		Format of the returned result. Can be either plain text (v2), `json` or `xml`. Default is `json`

Returns

Value	Description
`status`	The status of the call. Always `1` on success or `0` on error
`error`	Error code, `0` for no error otherwise check the list of error codes or the `remarks` parameter
`remarks`	Notes on the call. Always `Success` or error description

Errors

Error	Description
`101`	Check your credentialsReprodude
`215`	`groupId` parameter is missing
`217`	`groupId` not found in group list

<?php

  $endpoint = 'https:///group/deleteAllContacts';

  $parameters = array(
      'key'       => 'YOUR API KEY',
      'groupId'   => 'GROUP-ID',

      'type'      => 'json' // type of return format

      'type'      => 'xml'  // type of return format

      'type'      => 'v2'   // type of return format

);

  function call_endpoint($endpoint, $parameters){
      $c = curl_init();
      curl_setopt($c, CURLOPT_URL, $endpoint);
      curl_setopt($c, CURLOPT_POST, true);
      curl_setopt($c, CURLOPT_POSTFIELDS, $parameters);
      curl_setopt($c, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($c, CURLOPT_SSL_VERIFYPEER, false);
      $output =  curl_exec($c);
      curl_close($c);
      return $output;
  }

  $json = json_decode(call_endpoint($endpoint, $parameters), true);


  echo '<pre>';

  print_r($json);

  $xmldata = call_endpoint($endpoint, $parameters);


  if (function_exists('simplexml_load_string')){

    $xml = simplexml_load_string($xmldata);

  }else if (function_exists('xml_parser_create')){
    $xmlparser = xml_parser_create();
    xml_parse_into_struct($xmlparser, $xmldata, $xml);
    xml_parser_free($xmlparser);
  }

  echo '<pre>';

  print_r($xml);

  echo call_endpoint($endpoint, $parameters);

curl "https:///group/deleteAllContacts?\
key=YOUR-API-KEY&\
groupId=GROUP-ID&\
type=xml"

api/group/deleteContact

Deletes a contact reference from a group.
To delete a contact from the contact list and all references to groups you need to use the api/contact/delete endpoint

https://premium-sms.gr/api/group/deleteContact

Accepts

Parameter	Value	Description
`key`	API key	Account API key. [Required]
`groupId`	groupId	The `groupId` from which you want to delete a contact reference. [Required with contactId if no contactGroupId]
`contactId`	contactId	The `contactId` of the contact reference you want to delete. [Required with groupId if no contactGroupId]
`contactGroupId`	contactGroupId	The `contactGroupId` reference of the contact you want to delete. [Required if no groupId-contactId]
`type`		Format of the returned result. Can be either plain text (v2), `json` or `xml`. Default is `json`

Returns

Value	Description
`status`	The status of the call. Always `1` on success or `0` on error
`error`	Error code, `0` for no error otherwise check the list of error codes or the `remarks` parameter
`remarks`	Notes on the call. Always `Success` or error description

Errors

Error	Description
`101`	Check your credentialsReproduce
`215`	`groupId` parameter is missing
`217`	`groupId` not found in group list

<?php

  $endpoint = 'https:///group/deleteContact';

  $parameters = array(
      'key'       => 'YOUR API KEY',
      'groupId'   => 'GROUP-ID',
      'contactId' => 'CONTACT-ID',

      'type'      => 'json' // type of return format

      'type'      => 'xml'  // type of return format

      'type'      => 'v2'   // type of return format

);

  function call_endpoint($endpoint, $parameters){
      $c = curl_init();
      curl_setopt($c, CURLOPT_URL, $endpoint);
      curl_setopt($c, CURLOPT_POST, true);
      curl_setopt($c, CURLOPT_POSTFIELDS, $parameters);
      curl_setopt($c, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($c, CURLOPT_SSL_VERIFYPEER, false);
      $output =  curl_exec($c);
      curl_close($c);
      return $output;
  }

  $json = json_decode(call_endpoint($endpoint, $parameters), true);


  echo '<pre>';

  print_r($json);

  $xmldata = call_endpoint($endpoint, $parameters);


  if (function_exists('simplexml_load_string')){

    $xml = simplexml_load_string($xmldata);

  }else if (function_exists('xml_parser_create')){
    $xmlparser = xml_parser_create();
    xml_parse_into_struct($xmlparser, $xmldata, $xml);
    xml_parser_free($xmlparser);
  }

  echo '<pre>';

  print_r($xml);

  echo call_endpoint($endpoint, $parameters);

curl "https:///group/deleteContact?\
key=YOUR-API-KEY&\
groupId=GROUP-ID&\
contactId=CONTACT-ID&\
type=xml"

api/group/get

Returns a group from your group list and all associated contacts

https://premium-sms.gr/api/group/get

Accepts

Parameter	Value	Description
`key`	API key	Account API key. [Required]
`groupId`	groupId	The `groupId` of the group you want to get. A list of all groups is returned from api/group/list call. [Required]
`type`		Format of the returned result. Can be either plain text (v2), `json` or `xml`. Default is `json`

Returns

Value	Description
`group{` `name` `total` `contacts{` `contact{` `contactId` `mobile` `...` `}` `...` `}`	Group object with associated contact objects
`status`	The status of the call. Always `1` on success or `0` on error
`error`	Error code, `0` for no error otherwise check the list of error codes or the `remarks` parameter
`remarks`	Notes on the call. Always `Success` or error description

Errors

Error	Description
`101`	Check your credentialsReproduce
`215`	`groupId` parameter is missing
`217`	`groupId` not found in group list

<?php

  $endpoint = 'https:///group/get';

  $parameters = array(
      'key'       => 'YOUR API KEY',
      'groupId'   => 'GROUP-ID',

      'type'      => 'json' // type of return format

      'type'      => 'xml'  // type of return format

      'type'      => 'v2'   // type of return format

);

  function call_endpoint($endpoint, $parameters){
      $c = curl_init();
      curl_setopt($c, CURLOPT_URL, $endpoint);
      curl_setopt($c, CURLOPT_POST, true);
      curl_setopt($c, CURLOPT_POSTFIELDS, $parameters);
      curl_setopt($c, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($c, CURLOPT_SSL_VERIFYPEER, false);
      $output =  curl_exec($c);
      curl_close($c);
      return $output;
  }

  $json = json_decode(call_endpoint($endpoint, $parameters), true);


  echo '<pre>';

  print_r($json);

  $xmldata = call_endpoint($endpoint, $parameters);


  if (function_exists('simplexml_load_string')){

    $xml = simplexml_load_string($xmldata);

  }else if (function_exists('xml_parser_create')){
    $xmlparser = xml_parser_create();
    xml_parse_into_struct($xmlparser, $xmldata, $xml);
    xml_parser_free($xmlparser);
  }

  echo '<pre>';

  print_r($xml);

  echo call_endpoint($endpoint, $parameters);

curl "https:///group/get?\
key=YOUR-API-KEY&\
groupId=GROUP-ID&\
type=xml"

api/group/list

Returns a list of all groups

https://premium-sms.gr/api/group/list

Accepts

Parameter	Value	Description
`key`	API key	Account API key. [Required]
`type`		Format of the returned result. Can be either plain text (v2), `json` or `xml`. Default is `json`

Returns

Value	Description
`groups{` `group{` `groupId` `name` `}` `...` `}`	Array of group objects
`total`	Total records returned
`status`	The status of the call. Always `1` on success or `0` on error
`error`	Error code, `0` for no error otherwise check the list of error codes or the `remarks` parameter
`remarks`	Notes on the call. Always `Success` or error description

Errors

Error	Description
`101`	Check your credentialsReproduce

<?php

  $endpoint = 'https:///group/list';

  $parameters = array(
      'key'       => 'YOUR API KEY',

      'type'      => 'json' // type of return format

      'type'      => 'xml'  // type of return format

      'type'      => 'v2'   // type of return format

);

  function call_endpoint($endpoint, $parameters){
      $c = curl_init();
      curl_setopt($c, CURLOPT_URL, $endpoint);
      curl_setopt($c, CURLOPT_POST, true);
      curl_setopt($c, CURLOPT_POSTFIELDS, $parameters);
      curl_setopt($c, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($c, CURLOPT_SSL_VERIFYPEER, false);
      $output =  curl_exec($c);
      curl_close($c);
      return $output;
  }

  $json = json_decode(call_endpoint($endpoint, $parameters), true);


  echo '<pre>';

  print_r($json);

  $xmldata = call_endpoint($endpoint, $parameters);


  if (function_exists('simplexml_load_string')){

    $xml = simplexml_load_string($xmldata);

  }else if (function_exists('xml_parser_create')){
    $xmlparser = xml_parser_create();
    xml_parse_into_struct($xmlparser, $xmldata, $xml);
    xml_parser_free($xmlparser);
  }

  echo '<pre>';

  print_r($xml);

  echo call_endpoint($endpoint, $parameters);

curl "https:///group/list?\
key=YOUR-API-KEY&\
type=xml"

api/history

Gives access to all sms sent for each account

api/history/group/list

Returns a list of all group sms

https://premium-sms.gr/api/history/group/list

Accepts

Parameter	Value	Description
`key`	API key	Account API key. [Required]
`type`		Format of the returned result. Can be either plain text (v2), `json` or `xml`. Default is `json`

Returns

Value	Description
`historyGroup{` `groupId` `sender` `flash` `unicode` `timestamp` `text` `total` `cost` `sms{` `smsId` `contactId` `to` `status` `cost` `ttd` `}` `}` `...`	Array of historyGroup objects
`total`	Total records of historyGroup returned
`status`	The status of the call. Always `1` on success or `0` on error
`error`	Error code, `0` for no error otherwise check the list of error codes or the `remarks` parameter
`remarks`	Notes on the call. Always `Success` or error description

Errors

Error	Description
`101`	Check your credentialsReproduce

<?php

  $endpoint = 'https:///history/group/list';

  $parameters = array(
      'key'       => 'YOUR API KEY',

      'type'      => 'json' // type of return format

      'type'      => 'xml'  // type of return format

      'type'      => 'v2'   // type of return format

);

  function call_endpoint($endpoint, $parameters){
      $c = curl_init();
      curl_setopt($c, CURLOPT_URL, $endpoint);
      curl_setopt($c, CURLOPT_POST, true);
      curl_setopt($c, CURLOPT_POSTFIELDS, $parameters);
      curl_setopt($c, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($c, CURLOPT_SSL_VERIFYPEER, false);
      $output =  curl_exec($c);
      curl_close($c);
      return $output;
  }

  $json = json_decode(call_endpoint($endpoint, $parameters), true);


  echo '<pre>';

  print_r($json);

  $xmldata = call_endpoint($endpoint, $parameters);


  if (function_exists('simplexml_load_string')){

    $xml = simplexml_load_string($xmldata);

  }else if (function_exists('xml_parser_create')){
    $xmlparser = xml_parser_create();
    xml_parse_into_struct($xmlparser, $xmldata, $xml);
    xml_parser_free($xmlparser);
  }

  echo '<pre>';

  print_r($xml);

  echo call_endpoint($endpoint, $parameters);

curl "https:///history/group/list?\
key=YOUR-API-KEY&\
type=xml"

api/history/single/list

Returns a list of all single sms

https://premium-sms.gr/api/history/single/list

Accepts

Parameter	Value	Description
`key`	API key	Account API key. [Required]
`type`		Format of the returned result. Can be either plain text (v2), `json` or `xml`. Default is `json`

Returns

Value	Description
`sms{` `smsId` `sender` `to` `flash` `unicode` `timestamp` `text` `cost` `status` `ttd` `}` `...`	Array of sms
`total`	Total records of sms returned
`cost`	Total cost of all sms returned
`status`	The status of the call. Always `1` on success or `0` on error
`error`	Error code, `0` for no error otherwise check the list of error codes or the `remarks` parameter
`remarks`	Notes on the call. Always `Success` or error description

Errors

Error	Description
`101`	Check your credentialsReproduce

<?php

  $endpoint = 'https:///history/single/list';

  $parameters = array(
      'key'       => 'YOUR API KEY',

      'type'      => 'json' // type of return format

      'type'      => 'xml'  // type of return format

      'type'      => 'v2'   // type of return format

);

  function call_endpoint($endpoint, $parameters){
      $c = curl_init();
      curl_setopt($c, CURLOPT_URL, $endpoint);
      curl_setopt($c, CURLOPT_POST, true);
      curl_setopt($c, CURLOPT_POSTFIELDS, $parameters);
      curl_setopt($c, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($c, CURLOPT_SSL_VERIFYPEER, false);
      $output =  curl_exec($c);
      curl_close($c);
      return $output;
  }

  $json = json_decode(call_endpoint($endpoint, $parameters), true);


  echo '<pre>';

  print_r($json);

  $xmldata = call_endpoint($endpoint, $parameters);


  if (function_exists('simplexml_load_string')){

    $xml = simplexml_load_string($xmldata);

  }else if (function_exists('xml_parser_create')){
    $xmlparser = xml_parser_create();
    xml_parse_into_struct($xmlparser, $xmldata, $xml);
    xml_parser_free($xmlparser);
  }

  echo '<pre>';

  print_r($xml);

  echo call_endpoint($endpoint, $parameters);

curl "https:///history/single/list?\
key=YOUR-API-KEY&\
type=xml"

api/hlr

The api/hlr/* calls perform a real time Number Lookup providing information about number portability or/and physical geographical location of mobile numbers. HLR stands for Home Location Register.

The HLR lookup can be very useful for routing optimizations and particularly useful for authentication services.

Each call to the api/hlr/lookup costs 1/10 of an SMS

api/hlr/lookup

Accepted parameters are the API key of the account and any mobile number to query.

Each call of api/hlr/lookup costs 1/10 of an SMS and it is subtracted from the hlrBalance property of the account.

The hlrBalance of each account is initially 0.

As soon as the api/hlr/lookup is called it checkes if the hlrBalance is at least 1 and if it is 0 it converts 1 SMS from the account balance to 10 hlrBalance credits.

https://premium-sms.gr/api/hlr/lookup

Accepts

Parameter	Value	Description
`key`	API key	Account API key. [Required]
`mobile`	Mobile	Any mobile to check. Supports all countries and networks. [Required]
`type`		Format of the returned result. Can be either plain text (v2), `json` or `xml`. Default is `json`

Returns

Value	Description
`result`	Result of the query, successful if `OK`
`description`	Result description of the query
`mcc`	Current mobile country code
`mnc`	Current mobile network code
`network`	Name of the network
`country`	Country name
`countryCode`	Country call code
`ported`	`yes` if it has been ported
`cctld`	CCTLD of country
`mccInitial`	Initial country code
`mncInitial`	Initial network code
`status`	The status of the call. Always `1` on success or `0` on error
`error`	Error code, `0` for no error otherwise check the lookup of error codes or the `remarks` parameter
`remarks`	Notes on the call. Always `Success` or error description

Errors

Error	Description
`101`	Check your credentials
`105`	Account out of balance
`201`	Failed to parse `mobile` to MSISDN (international format mobile number)
`205`	`mobile` parameter is empty

<?php

  $endpoint = 'https:///hlr/lookup';

  $parameters = array(
      'key'     => 'YOUR API KEY',
      'mobile'  => '306971000000',

      'type'    => 'json' // type of return format

      'type'    => 'xml'  // type of return format

      'type'    => 'v2'   // type of return format

);

  function call_endpoint($endpoint, $parameters){
      $c = curl_init();
      curl_setopt($c, CURLOPT_URL, $endpoint);
      curl_setopt($c, CURLOPT_POST, true);
      curl_setopt($c, CURLOPT_POSTFIELDS, $parameters);
      curl_setopt($c, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($c, CURLOPT_SSL_VERIFYPEER, false);
      $output =  curl_exec($c);
      curl_close($c);
      return $output;
  }

  $json = json_decode(call_endpoint($endpoint, $parameters), true);


  echo '<pre>';

  print_r($json);

  $xmldata = call_endpoint($endpoint, $parameters);


  if (function_exists('simplexml_load_string')){

    $xml = simplexml_load_string($xmldata);

  }else if (function_exists('xml_parser_create')){
    $xmlparser = xml_parser_create();
    xml_parse_into_struct($xmlparser, $xmldata, $xml);
    xml_parser_free($xmlparser);
  }

  echo '<pre>';

  print_r($xml);

  echo call_endpoint($endpoint, $parameters);

curl "https:///hlr/lookup?\
key=YOUR-API-KEY&\
mobile=MOBILE NUMBER&\
type=xml"

api/purchase

Gives access to account history of purchases

api/purchase/list

Returns a list of all purchased sms

https://premium-sms.gr/api/purchase/list

Accepts

Parameter	Value	Description
`key`	API key	Account API key. [Required]
`type`		Format of the returned result. Can be either plain text (v2), `json` or `xml`. Default is `json`

Returns

Value	Description
`purchases{` `purchase{` `purchaseId` `timestamp` `cost` `sms` `}` `...` `}`	Array of purchase objects
`total`	Total records of purchases returned
`status`	The status of the call. Always `1` on success or `0` on error
`error`	Error code, `0` for no error otherwise check the list of error codes or the `remarks` parameter
`remarks`	Notes on the call. Always `Success` or error description

Errors

Error	Description
`101`	Check your credentialsReproduce

<?php

  $endpoint = 'https:///purchase/list';

  $parameters = array(
      'key'       => 'YOUR API KEY',

      'type'      => 'json' // type of return format

      'type'      => 'xml'  // type of return format

      'type'      => 'v2'   // type of return format

);

  function call_endpoint($endpoint, $parameters){
      $c = curl_init();
      curl_setopt($c, CURLOPT_URL, $endpoint);
      curl_setopt($c, CURLOPT_POST, true);
      curl_setopt($c, CURLOPT_POSTFIELDS, $parameters);
      curl_setopt($c, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($c, CURLOPT_SSL_VERIFYPEER, false);
      $output =  curl_exec($c);
      curl_close($c);
      return $output;
  }

  $json = json_decode(call_endpoint($endpoint, $parameters), true);


  echo '<pre>';

  print_r($json);

  $xmldata = call_endpoint($endpoint, $parameters);


  if (function_exists('simplexml_load_string')){

    $xml = simplexml_load_string($xmldata);

  }else if (function_exists('xml_parser_create')){
    $xmlparser = xml_parser_create();
    xml_parse_into_struct($xmlparser, $xmldata, $xml);
    xml_parser_free($xmlparser);
  }

  echo '<pre>';

  print_r($xml);

  echo call_endpoint($endpoint, $parameters);

curl "https:///purchase/list?\
key=YOUR-API-KEY&\
type=xml"

api/status

Returns the statuses of your messages

api/status/get

Returns all sms whose status has been changed since last call

https://premium-sms.gr/api/status/get

Accepts

Parameter	Value	Description
`key`	API key	Account API key. [Required]
`type`		Format of the returned result. Can be either plain text (v2), `json` or `xml`. Default is `json`

Returns

Value	Description
`sms{` `smsId` `status` `}` `...`	Array of sms ids and statuses
`total`	Total records returned
`status`	The status of the call. Always `1` on success or `0` on error
`error`	Error code, `0` for no error otherwise check the list of error codes or the `remarks` parameter
`remarks`	Notes on the call. Always `Success` or error description

Errors

Error	Description
`101`	Check your credentialsReproduce

<?php

  $endpoint = 'https:///status/get';

  $parameters = array(
      'key'       => 'YOUR API KEY',

      'type'      => 'json' // type of return format

      'type'      => 'xml'  // type of return format

      'type'      => 'v2'   // type of return format

);

  function call_endpoint($endpoint, $parameters){
      $c = curl_init();
      curl_setopt($c, CURLOPT_URL, $endpoint);
      curl_setopt($c, CURLOPT_POST, true);
      curl_setopt($c, CURLOPT_POSTFIELDS, $parameters);
      curl_setopt($c, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($c, CURLOPT_SSL_VERIFYPEER, false);
      $output =  curl_exec($c);
      curl_close($c);
      return $output;
  }

  $json = json_decode(call_endpoint($endpoint, $parameters), true);


  echo '<pre>';

  print_r($json);

  $xmldata = call_endpoint($endpoint, $parameters);


  if (function_exists('simplexml_load_string')){

    $xml = simplexml_load_string($xmldata);

  }else if (function_exists('xml_parser_create')){
    $xmlparser = xml_parser_create();
    xml_parse_into_struct($xmlparser, $xmldata, $xml);
    xml_parser_free($xmlparser);
  }

  echo '<pre>';

  print_r($xml);

  echo call_endpoint($endpoint, $parameters);

curl "https:///status/get?\
key=YOUR-API-KEY&\
type=xml"

api/status/sms

Returns the status of a specific sms

https://premium-sms.gr/api/status/sms

Accepts

Parameter	Value	Description
`key`	API key	Account API key. [Required]
`smsId`	smsId	SMS id to get the status. [Required]
`type`		Format of the returned result. Can be either plain text (v2), `json` or `xml`. Default is `json`

Returns

Value	Description
`sms{` `smsId` `status` `}`	The status of the smsId
`status`	The status of the call. Always `1` on success or `0` on error
`error`	Error code, `0` for no error otherwise check the list of error codes or the `remarks` parameter
`remarks`	Notes on the call. Always `Success` or error description

Errors

Error	Description
`101`	Check your credentialsReproduce

<?php

  $endpoint = 'https:///status/sms';

  $parameters = array(
      'key'       => 'YOUR API KEY',
      'smsid'     => 'SMS ID',

      'type'      => 'json' // type of return format

      'type'      => 'xml'  // type of return format

      'type'      => 'v2'   // type of return format

);

  function call_endpoint($endpoint, $parameters){
      $c = curl_init();
      curl_setopt($c, CURLOPT_URL, $endpoint);
      curl_setopt($c, CURLOPT_POST, true);
      curl_setopt($c, CURLOPT_POSTFIELDS, $parameters);
      curl_setopt($c, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($c, CURLOPT_SSL_VERIFYPEER, false);
      $output =  curl_exec($c);
      curl_close($c);
      return $output;
  }

  $json = json_decode(call_endpoint($endpoint, $parameters), true);


  echo '<pre>';

  print_r($json);

  $xmldata = call_endpoint($endpoint, $parameters);


  if (function_exists('simplexml_load_string')){

    $xml = simplexml_load_string($xmldata);

  }else if (function_exists('xml_parser_create')){
    $xmlparser = xml_parser_create();
    xml_parse_into_struct($xmlparser, $xmldata, $xml);
    xml_parser_free($xmlparser);
  }

  echo '<pre>';

  print_r($xml);

  echo call_endpoint($endpoint, $parameters);

curl "https:///status/sms?\
key=YOUR-API-KEY&\
smsId=SMS-ID&\
type=xml"

api/user

Manipulate your account and your sub-users accounts.

More endpoints coming soon:

api/user/delete
api/user/email
api/user/emailAll
api/user/get
api/user/password
api/user/sms
api/user/smsAll
api/user/update

api/user/add

Creates a new sub-account under the main user account

https://premium-sms.gr/api/user/add

Accepts

Parameter	Value	Description
`key`	API key	Main account API key. [Required]
`email`	email	The `email` of the user to add. [Required]
`password`	password	The password of the account to add. [Required]
`type`		Format of the returned result. Can be either plain text (v2), `json` or `xml`. Default is `json`

Returns

Value	Description
`user{` `userId` `balance` `}`	Balance of user
`status`	The status of the call. Always `1` on success or `0` on error
`error`	Error code, `0` for no error otherwise check the list of error codes or the `remarks` parameter
`remarks`	Notes on the call. Always `Success` or error description

Errors

Error	Description
`101`	Check your credentials
`601`	User is registered
`602`	Reached maximum users. Contact support

<?php

  $endpoint = 'https:///user/add';

  $parameters = array(
      'key'       => 'YOUR API KEY',
      'email'     => 'VALID-EMAIL',
      'password'  => 'PASSWORD',
          'type'      => 'json' // type of return format
          'type'      => 'xml'  // type of return format
          'type'      => 'v2'   // type of return format
  );
//remove_circle_outline  function call_endpoint($endpoint, $parameters){
      $c = curl_init();
      curl_setopt($c, CURLOPT_URL, $endpoint);
      curl_setopt($c, CURLOPT_POST, true);
      curl_setopt($c, CURLOPT_POSTFIELDS, $parameters);
      curl_setopt($c, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($c, CURLOPT_SSL_VERIFYPEER, false);
      $output =  curl_exec($c);
      curl_close($c);
      return $output;
  }


  $json = json_decode(call_endpoint($endpoint, $parameters), true);

  echo '<pre>';
  print_r($json);

  $xmldata = call_endpoint($endpoint, $parameters);

  if (function_exists('simplexml_load_string')){
    $xml = simplexml_load_string($xmldata);
  }else if (function_exists('xml_parser_create')){
    $xmlparser = xml_parser_create();
    xml_parse_into_struct($xmlparser, $xmldata, $xml);
    xml_parser_free($xmlparser);
  }

  echo '<pre>';
  print_r($xml);

  echo call_endpoint($endpoint, $parameters);

?>

curl "https:///user/add?\
key=YOUR-API-KEY&\
email=VALID-EMAIL&\
password=PASSWORD&\
type=xml"

api/user/list

Returns a list of all sub-accounts

https://premium-sms.gr/api/user/list

Accepts

Parameter	Value	Description
`key`	API key	Account API key. [Required]
`type`		Format of the returned result. Can be either plain text (v2), `json` or `xml`. Default is `json`

Returns

Value	Description
`user{` `userId` `username` `email` `balance` `mobile` `key` `}` `...`	Array of users
`total`	Total records returned
`status`	The status of the call. Always `1` on success or `0` on error
`error`	Error code, `0` for no error otherwise check the list of error codes or the `remarks` parameter
`remarks`	Notes on the call. Always `Success` or error description

Errors

Error	Description
`101`	Check your credentialsReproduce

<?php

  $endpoint = 'https:///user/list';

  $parameters = array(
      'key'       => 'YOUR API KEY',

      'type'      => 'json' // type of return format

      'type'      => 'xml'  // type of return format

      'type'      => 'v2'   // type of return format

);

  function call_endpoint($endpoint, $parameters){
      $c = curl_init();
      curl_setopt($c, CURLOPT_URL, $endpoint);
      curl_setopt($c, CURLOPT_POST, true);
      curl_setopt($c, CURLOPT_POSTFIELDS, $parameters);
      curl_setopt($c, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($c, CURLOPT_SSL_VERIFYPEER, false);
      $output =  curl_exec($c);
      curl_close($c);
      return $output;
  }

  $json = json_decode(call_endpoint($endpoint, $parameters), true);


  echo '<pre>';

  print_r($json);

  $xmldata = call_endpoint($endpoint, $parameters);


  if (function_exists('simplexml_load_string')){

    $xml = simplexml_load_string($xmldata);

  }else if (function_exists('xml_parser_create')){
    $xmlparser = xml_parser_create();
    xml_parse_into_struct($xmlparser, $xmldata, $xml);
    xml_parser_free($xmlparser);
  }

  echo '<pre>';

  print_r($xml);

  echo call_endpoint($endpoint, $parameters);

curl "https:///user/list?\
key=YOUR-API-KEY&\
type=xml"

api/user/topup

Adds sms to a sub-account taken from the main user account

https://premium-sms.gr/api/user/topup

Accepts

Parameter	Value	Description
`key`	API key	Main account API key from which the sms will be taken. [Required]
`userId`	userId	The `userId` of the user to topup. [Required]
`sms`	sms	How many sms to topup. [Required]
`cost`	cost	The cost of the sms. [Required]
`type`		Format of the returned result. Can be either plain text (v2), `json` or `xml`. Default is `json`

Returns

Value	Description
`user{` `userId` `balance` `}`	Balance of user
`status`	The status of the call. Always `1` on success or `0` on error
`error`	Error code, `0` for no error otherwise check the list of error codes or the `remarks` parameter
`remarks`	Notes on the call. Always `Success` or error description

Errors

Error	Description
`101`	Check your credentialsReproduce
`206`	Parameter `sms` is malformed
`207`	Parameter `cost` is malformed
`208`	Parameter `userId` is empty
`209`	User is not found in the users list
`210`	Removing sms from user. User has not enough balance to remove
`211`	The main account has not enough balance

<?php

  $endpoint = 'https:///user/topup';

  $parameters = array(
      'key'       => 'YOUR API KEY',
      'userId'    => 'SUB-USER-ID',
      'sms'       => 100,
      'cost'      => 4,

      'type'      => 'json' // type of return format

      'type'      => 'xml'  // type of return format

      'type'      => 'v2'   // type of return format

);

  function call_endpoint($endpoint, $parameters){
      $c = curl_init();
      curl_setopt($c, CURLOPT_URL, $endpoint);
      curl_setopt($c, CURLOPT_POST, true);
      curl_setopt($c, CURLOPT_POSTFIELDS, $parameters);
      curl_setopt($c, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($c, CURLOPT_SSL_VERIFYPEER, false);
      $output =  curl_exec($c);
      curl_close($c);
      return $output;
  }

  $json = json_decode(call_endpoint($endpoint, $parameters), true);


  echo '<pre>';

  print_r($json);

  $xmldata = call_endpoint($endpoint, $parameters);


  if (function_exists('simplexml_load_string')){

    $xml = simplexml_load_string($xmldata);

  }else if (function_exists('xml_parser_create')){
    $xmlparser = xml_parser_create();
    xml_parse_into_struct($xmlparser, $xmldata, $xml);
    xml_parser_free($xmlparser);
  }

  echo '<pre>';

  print_r($xml);

  echo call_endpoint($endpoint, $parameters);

curl "https:///user/topup?\
key=YOUR-API-KEY&\
userId=USER-ID&\
sms=100&\
cost=4&\
type=xml"

api/user/comment

add, delete and list endpoints to keep track of all actions of the sub-users accounts

api/user/comment/add

Adds a comment to a sub-account user

https://premium-sms.gr/api/user/comment/add

Accepts

Parameter	Value	Description
`key`	API key	Account API key. [Required]
`userId`	userId	The `userId` of the user. [Required]
`comment`	Comment	Comment to add
`type`		Format of the returned result. Can be either plain text (v2), `json` or `xml`. Default is `json`

Returns

Value	Description
`comment{` `commentId` `}`	Comment id
`status`	The status of the call. Always `1` on success or `0` on error
`error`	Error code, `0` for no error otherwise check the list of error codes or the `remarks` parameter
`remarks`	Notes on the call. Always `Success` or error description

Errors

Error	Description
`101`	Check your credentialsReproduce
`208`	Parameter `userId` is empty
`209`	User is not found in the users list
`212`	No `comment` parameter

<?php

  $endpoint = 'https:///user/comment/add';

  $parameters = array(
      'key'       => 'YOUR API KEY',
      'userId'    => 'SUB-USER-ID',
      'comment'   => 'New comment',

      'type'      => 'json' // type of return format

      'type'      => 'xml'  // type of return format

      'type'      => 'v2'   // type of return format

);

  function call_endpoint($endpoint, $parameters){
      $c = curl_init();
      curl_setopt($c, CURLOPT_URL, $endpoint);
      curl_setopt($c, CURLOPT_POST, true);
      curl_setopt($c, CURLOPT_POSTFIELDS, $parameters);
      curl_setopt($c, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($c, CURLOPT_SSL_VERIFYPEER, false);
      $output =  curl_exec($c);
      curl_close($c);
      return $output;
  }

  $json = json_decode(call_endpoint($endpoint, $parameters), true);


  echo '<pre>';

  print_r($json);

  $xmldata = call_endpoint($endpoint, $parameters);


  if (function_exists('simplexml_load_string')){

    $xml = simplexml_load_string($xmldata);

  }else if (function_exists('xml_parser_create')){
    $xmlparser = xml_parser_create();
    xml_parse_into_struct($xmlparser, $xmldata, $xml);
    xml_parser_free($xmlparser);
  }

  echo '<pre>';

  print_r($xml);

  echo call_endpoint($endpoint, $parameters);

curl "https:///user/comment/add?\
key=YOUR-API-KEY&\
userId=USER-ID&\
comment=new-comment&\
type=xml"

api/user/comment/delete

Deletes a comment from a sub-account user

https://premium-sms.gr/api/user/comment/delete

Accepts

Parameter	Value	Description
`key`	API key	Account API key. [Required]
`commentId`	Comment id	Comment id to delete
`type`		Format of the returned result. Can be either plain text (v2), `json` or `xml`. Default is `json`

Returns

Value	Description
`status`	The status of the call. Always `1` on success or `0` on error
`error`	Error code, `0` for no error otherwise check the list of error codes or the `remarks` parameter
`remarks`	Notes on the call. Always `Success` or error description

Errors

Error	Description
`101`	Check your credentialsReproduce
`212`	No `comment` parameter
`220`	Comment with `commentId` not found

<?php

  $endpoint = 'https:///user/comment/delete';

  $parameters = array(
      'key'       => 'YOUR API KEY',
      'commentId' => 'COMMENT-ID',

      'type'      => 'json' // type of return format

      'type'      => 'xml'  // type of return format

      'type'      => 'v2'   // type of return format

);

  function call_endpoint($endpoint, $parameters){
      $c = curl_init();
      curl_setopt($c, CURLOPT_URL, $endpoint);
      curl_setopt($c, CURLOPT_POST, true);
      curl_setopt($c, CURLOPT_POSTFIELDS, $parameters);
      curl_setopt($c, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($c, CURLOPT_SSL_VERIFYPEER, false);
      $output =  curl_exec($c);
      curl_close($c);
      return $output;
  }

  $json = json_decode(call_endpoint($endpoint, $parameters), true);


  echo '<pre>';

  print_r($json);

  $xmldata = call_endpoint($endpoint, $parameters);


  if (function_exists('simplexml_load_string')){

    $xml = simplexml_load_string($xmldata);

  }else if (function_exists('xml_parser_create')){
    $xmlparser = xml_parser_create();
    xml_parse_into_struct($xmlparser, $xmldata, $xml);
    xml_parser_free($xmlparser);
  }

  echo '<pre>';

  print_r($xml);

  echo call_endpoint($endpoint, $parameters);

curl "https:///user/comment/delete?\
key=YOUR-API-KEY&\
commentId=COMMENT-ID&\
type=xml"

api/user/comment/list

Returns a list of all comments for a sub-account user

https://premium-sms.gr/api/user/comment/list

Accepts

Parameter	Value	Description
`key`	API key	Account API key. [Required]
`userId`	userId	The `userId` of the user. [Required]
`type`		Format of the returned result. Can be either plain text (v2), `json` or `xml`. Default is `json`

Returns

Value	Description
`comments{` `comment{` `commentId` `timestamp` `comment` `}` `...` `}`	Array of comments
`total`	Total comments returned
`status`	The status of the call. Always `1` on success or `0` on error
`error`	Error code, `0` for no error otherwise check the list of error codes or the `remarks` parameter
`remarks`	Notes on the call. Always `Success` or error description

Errors

Error	Description
`101`	Check your credentialsReproduce
`208`	Parameter `userId` is empty
`209`	User is not found in the users list

<?php

  $endpoint = 'https:///user/comment/list';

  $parameters = array(
      'key'       => 'YOUR API KEY',
      'userId'    => 'SUB-USER-ID',

      'type'      => 'json' // type of return format

      'type'      => 'xml'  // type of return format

      'type'      => 'v2'   // type of return format

);

  function call_endpoint($endpoint, $parameters){
      $c = curl_init();
      curl_setopt($c, CURLOPT_URL, $endpoint);
      curl_setopt($c, CURLOPT_POST, true);
      curl_setopt($c, CURLOPT_POSTFIELDS, $parameters);
      curl_setopt($c, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($c, CURLOPT_SSL_VERIFYPEER, false);
      $output =  curl_exec($c);
      curl_close($c);
      return $output;
  }

  $json = json_decode(call_endpoint($endpoint, $parameters), true);


  echo '<pre>';

  print_r($json);

  $xmldata = call_endpoint($endpoint, $parameters);


  if (function_exists('simplexml_load_string')){

    $xml = simplexml_load_string($xmldata);

  }else if (function_exists('xml_parser_create')){
    $xmlparser = xml_parser_create();
    xml_parse_into_struct($xmlparser, $xmldata, $xml);
    xml_parser_free($xmlparser);
  }

  echo '<pre>';

  print_r($xml);

  echo call_endpoint($endpoint, $parameters);

curl "https:///user/comment/list?\
key=YOUR-API-KEY&\
userId=USER-ID&\
type=xml"

thank you, thank you

myschool.sch.gr

All schools in Greece can integrate their central school management system myschool.sch.gr with premium-sms.gr to enable direct sms messaging from myschool system to

Students
Parents
Educational personel and others

Settings for myschool.sch.gr

In field 1. enter your account API key
You will find it once you sign in with your account

In field 2. enter the sender of the sms
Must me up to 11 latin characters without spaces

- graphic_eq
- face
- settings
GENERAL SETTINGS
- Notifications
  
  Use checkboxes when looking for yes or no answers.
- Show recent activity
  
  The for attribute is necessary to bind our custom checkbox with the input.
- Notifications
  
  Use checkboxes when looking for yes or no answers.
- Show recent activity
  
  The for attribute is necessary to bind our custom checkbox with the input.
- Show your emails
  
  Use checkboxes when looking for yes or no answers.
- Show Task statistics
  
  The for attribute is necessary to bind our custom checkbox with the input.
Elizabeth Elliott 5.00 AM
Thank you
Mary Adams 4.14 AM
Hello Boo
Caleb Richards 9.00 PM
Keny !
June Lane 4.14 AM
Ohh God
Edward Fletcher 5.15 PM
Love you
Crystal Bates 8.00 AM
Can we
Nathan Watts 9.53 PM
Great!
Willard Wood 4.20 AM
Do it
Ronnie Ellis 5.30 PM
Got that
Gwendolyn Wood 4.34 AM
Like you
Daniel Russell 12.00 AM
Thank you
Sarah Graves 11.14 PM
Okay you
Andrew Hoffman 7.30 PM
Can do
Camila Lynch 2.00 PM
Leave it

RECENT ACTIVITY

just now
Jim Doe Purchased new equipments for zonal office.

Yesterday
Your Next flight for USA will be on 15th August 2015.

5 Days Ago
Natalya Parker Send you a voice mail for next conference.

1 Week Ago
Jessy Jay open a new store at S.G Road.

2 Week Ago
voice mail for conference.

1 Month Ago
Natalya Parker Send you a voice mail for next conference.

3 Month Ago
Jessy Jay open a new store at S.G Road.

1 Year Ago
voice mail for conference.

Overview

Create an account

Authentication

REST SMS API

api/mobile

api/mobile/check

api/key

api/key/get

api/key/reset

api/sms

api/sms/bulk

api/sms/cancel

api/sms/send

api/viber

api/viber/send

api/viber/bulk

api/viber/balance

api/me

api/me/balance

api/2fa

api/2fa/send

api/2fa/check

api/contact

api/contact/add

api/contact/delete

api/contact/get

api/contact/list

api/contact/update

api/group

api/group/add

api/group/addContact

api/group/delete

api/group/deleteAllContacts

api/group/deleteContact

api/group/get

api/group/list

api/history

api/history/group/list

api/history/single/list

api/hlr

api/hlr/lookup

api/purchase

api/purchase/list

api/status

api/status/get

api/status/sms

api/user

api/user/add

api/user/list

api/user/topup

api/user/comment

api/user/comment/add

api/user/comment/delete

api/user/comment/list

myschool.sch.gr