Search APIs helpdesk

Specification

You are here:

API URL

The URL used to send the HTTP requests:

https://sms.gretor.net/api/1.0/simple/transactional

Supported methods

It is strictly prohibited to exploit transactional SMS for promotional/marketing uses. It must be used for notification purposes only – as an SMS notification.

Parameters table

PARAMETER NAME VALUE MANDATORY DEFAULT VALUE
application_id Application indentificator Yes
application_token Application authentication token Yes
number Recipient number Yes
text Text of SMS message (max. 612 characters, or 268 characters if Unicode is used), UTF-8 enconding Yes
unicode Yes/true/1 for Unicode SMS, no/false/0 for 7bit SMS No false
flash Yes/true/1 for flash SMS No false
sender_id Sender ID, viz sender ID type No gSystem
sender_id_value Sender value of gOwn or gText No null
country Provide the recipients’ numbers in an international format (with prefix, e.g. 44) or add the country code in ISO 3166-1 alpha-2 format (7820125799 + GB = 447820125799). See the country example request. If null, your set timezone will be used to fill the information No null
schedule Schedule the sending time and date in unix timestamp, or ISO 8601. No Now
duplicates_check Select on to prevent sending duplicate messages to the same phone number. Messages with the same text sent to the same number will be removed if there is a time interval shorter than 5 mins. If off no duplicates will be removed. No off

Sender ID type sender_id

VALUE DESCRIPTION
gSystem System number
gShort Short Code
gText Text sender
gOwn Own Number (number verification required)
<int> Gretor SMS Profile ID

Response to this command may be:

In case of success:

{
    "data": {
        "status": "accepted",
        "sms_id": "tmpde1bcd4b1d1",
        "price": 0.02,
        "credit": 215.81380,
        "number": "447700900000"
    }
}

In case of error:

{
  "error": "authentication_failed",
  "code": 401
}