SMS sending

Single message


Partner sends HTTP request to the address

Parameters must be URL-encoded and coded by UTF-8 format. The data submitted via GET method:

 Title  Description  Example
 username  Username  demo
 password  Login password  demo
 action  Requested action, possible values:
 • send – send SMS (default value);
 • validate – message error check, sending will not be executed;
 sender  Sender's phone number.
 Option can be activated by a separate agreement,
 in advance specifying what values will be used
 phone  Recipient's phone number (MSISDN),
 international format „370xxxyyyyy“
 sms  Message text (if WapPush, link title - tekstas)  Demo SMS API message
 url  (not necessary) If WapPush, then link title.
 ident  (not necessary) External system identifier, eg. ad number  LT123
 type  (not necessary) Sending type (SMS, WapPush), by default SMS  SMS
 service_id  (not necessary) MBS service ID, to easy distinguish
 how much sending for different services costs for you.
 operator  (not necessary)
 Should be indicated only if the partner knows the recipient's operator.
 In this case message will be sent via channel with best price
 for that particular operator.
 Format: tele2_lt, bite_lt, tele2_lv ir kt.
 send_date  (not necessary) Message sending date.
 Should be indicated only if the partner wants to send messages later.
 If date is not specified, the message will be sent immediately.
 2016-11-13 14:00:00
 timezone  (not necessary) Message sending date time zone.
 Should be indicated only if the partner wants to send messages later
 and specify date for other time zone.
 If not specified – timezone „Europe/Vilnius“ is used as default.
 dlrurl  (not necessary) URL address for message delivery report.
 Should be specified only if partner will process delivery reports.
 priority  (not necessary) Message priority.
 Higher priority is used for important messages to deliver them
 earlier than other messages
 (eg., registration code vs bulk advertisement).
  • 2 – Very fast;
  • 3 – Fast enough;
  • 4 – Normal;
  • 5 – No rush;
  • 6 – Absolutely not hurry;
 charset  (not necessary) Outgoing text rules (encoding):
  • lisp – lisped characters;
  • windows-1252 – Latin characters;
  • windows-1257 – Baltic characters;
  • windows-1251 – Cyrillic characters;
  • utf-8 – Any characters;
  If not specified, MBS, depending on the service settings,
 will lisp text or will apply the most suitable encoding for that text.
 sms_template  Your message template title.
 The message text will be uploaded from the template.
 sms_vars  Template dynamic places values.
 Each value is described separately.
 Dinamic places in template should be specified as %{name}%






Once the HTTP GET request is sent, MBS returns a text string response with the format „{RESULT} {RESULT_DESCRIPTION}“. A list of possible results:

 Result  Description
 OK {SMS_ID}  MBS accepted SMS request from partner
 and gave him a unique MBS system identifier - SMS_ID (eg. 12345)
 ERROR {ERROR_DESCRIPTION}  SMS request was not accepted


HTTP request example:

Do not forget to code GET parameters (URL-encode). For URL-encode coding in PHP language http_build_query() or urlencode() functions should be used



The message is sent to the user and the result is printed to the screen.

If you work with PHP language you can use MBS PHP library class SMSComm

< !--?php
 * Raw SMS sending example
 * @see MBSLib/examples/simple/send_sms.php
 * @package RawExamples
 * @author Valdas Petrulis 

// Messaging Configuration
define('SMSCOMM_SMS_URL', '');
define('SMSCOMM_USERNAME', 'demo');
define('SMSCOMM_PASSWORD', 'demo');

$url = SMSCOMM_SMS_URL.'?'.http_build_query(array(
    'username'  => SMSCOMM_USERNAME,
    'password'  => SMSCOMM_PASSWORD,
    'sender'    => 'VeroDemo',
    'phone'     => '37065659515',
    'sms'       => 'Demo SMS API message',

$result = trim(file_get_contents($url));
if( $result=='OK' ) {
	echo 'SMS sent';
} else {
	echo 'Error in SMS: ' . $result;




PHP library used to connect to the Vero system, you can download here: MBS library

To unsubscribe service in Lithuania send SMS to short code 1679. Message price is 0.09 Eur.

Read more