PHPackages                             vzool/malath\_sms - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. vzool/malath\_sms

ActiveLibrary

vzool/malath\_sms
=================

Malaz SMS PHP API

v0.04(7y ago)31.9k1[1 issues](https://github.com/vzool/Malath_SMS/issues)[1 PRs](https://github.com/vzool/Malath_SMS/pulls)MITPHPPHP ^5.4 || ^7.1

Since Jun 26Pushed 4y ago2 watchersCompare

[ Source](https://github.com/vzool/Malath_SMS)[ Packagist](https://packagist.org/packages/vzool/malath_sms)[ RSS](/packages/vzool-malath-sms/feed)WikiDiscussions master Synced today

READMEChangelogDependenciesVersions (5)Used By (0)

Malath SMS API for PHP Composer
===============================

[](#malath-sms-api-for-php-composer)

[![Malath Logo](https://raw.githubusercontent.com/vzool/Malath_SMS/master/docs/logo.png)](https://sms.malath.net.sa)

Installation
------------

[](#installation)

```
composer require vzool/malath_sms
```

**Extension: ext-curl is required.**

Usage
-----

[](#usage)

### Add sender

[](#add-sender)

```
$DTT_SMS = new Vzool/Malath/Malath_SMS($UserName, $Password, 'UTF-8');
$Send = $DTT_SMS->AddSender($Name);
```

### Check UserName &amp; Password

[](#check-username--password)

```
$DTT_SMS    = new Vzool/Malath/Malath_SMS($UserName, $Password, 'UTF-8');
$CheckUser  = $DTT_SMS->CheckUserPassword();
```

### Send SMS

[](#send-sms)

```
$DTT_SMS    = new Vzool/Malath/Malath_SMS($UserName, $Password, 'UTF-8');
$Send = $DTT_SMS->Send_SMS($Mobiles, $Originator, $SMS_Msg);
```

HTTP Request Documentation:
---------------------------

[](#http-request-documentation)

1. Description – Bulk SMS.
2. HTTP Connectivity.
3. History.
4. SMS Specifications.
5. HTTP URLs.

a. Check User Name and Password.

b. Sending Process - Single &amp; Multiple Messages URL.

c. Balance query.

d. Send Scheduled Message.

e. Insert Main Group.

f. Insert Sub Group.

g. Add Contact to Group.

h. add sender name.

I. Review sender name.

Bulk SMS
========

[](#bulk-sms)

In an era of rapid technological advancements, mode of

communication is becoming lot more sophisticated. A new and

modern way of reaching your target market and communicating

them is through SMS (Short Messaging Service). Malath SMS

offers you this mode of communication through its bulk SMS

service.

Bulk SMS service reaches your target audience at a very

economical price, putting behind the conventional mode of

advertising that costs you in multiples compared to SMS service.

High Speed messaging in world, yet simple and reliable. We provide

you the fastest messaging solutions allowing the organizations to

communicate with their clients on urgent and personal basis.

HTTP Connectivity
=================

[](#http-connectivity)

This document covers the HTTP method of connectivity. Additional

documents are available for other types of connectivity.

This is one of the simpler server-based forms of communication to

with our gateway. It can be used either in the form of a HTTP POST

or as an URL. We recommend POST for larger data transfer, due

to the size limitation of GET.

Communication to our API can be done via HTTP on port 80. All

calls to the API must be URL-encoded.

The beauty and add-on advantage of http connectivity is that you

can check or access the gateway even on web based applications.

The parameter names are case-sensitive, so it is important to read

entire document prior to seeking assistance from IBS.

History

This part of URL deals with the messages history and that

includes the messages delivered and outstanding. The beauty and

add-on advantage of http connectivity is that you can check or

access the gateway even on web based applications.

Login to  to history. You can check

whether messages are delivered or outstanding.

SMS Specifications

Unicode:

Single Message: A message in Unicode format can contain up to

70 characters.

Multiple Message: Once the message exceeds more than 70

characters it would be sent in multiples with 67 characters in each

message.

English:

Single Message: A message in English format can contain up to

160 characters.

Multiple Message: Once the message exceeds more than 160

characters it would be sent in multiples with 134 characters in

each message.

HTTP URLS
=========

[](#http-urls)

A- Check User Name and Password
-------------------------------

[](#a--check-user-name-and-password)

You can check your user name and password from API.

```
URL for Check User Name and Password
http://sms.malath.net.sa/apis/users.aspx?code=1&username=xxxx&password=xxxx

```

Return Codes

### 3101

[](#3101)

```
Success

```

### 3102

[](#3102)

```
Wrong Password

```

### 3103

[](#3103)

```
User Name Don’t Exist

```

### 3104

[](#3104)

```
Account Inactive

```

### 3105

[](#3105)

```
Missing Parameter

```

B- Sending Process:

Unicode:

```
URL for Single SMS service
http://sms.malath.net.sa/httpSmsProvider.aspx?username=xxxxxx&password=xxxxxx&mobile= 9665 x
xxxxx&unicode=U&message=062A062C
0020062C064806270644&sender=your sender name here

```

```
URL for Multiple SMS service
http://sms.malath.net.sa/httpSmsProvider.aspx?username=xxxxxx&password=xxxxxx&mobile=9665x
xxxxx,9665xxxxxx&unicode=U&message=062A062C
8064206390020062C064806270644&sender=your sender name here

```

```
In this URL for sending on multiple mobile you have to separate with comma(,)

```

Note: must be active your sender name before do any test.

English:

URL for Single SMS service \[[http://sms.malath.net.sa/httpSmsProvider.aspx?username=xxxxxx&amp;password=xxxxxx&amp;mobile=9665xxxxxx&amp;unicode=E&amp;message=test](http://sms.malath.net.sa/httpSmsProvider.aspx?username=xxxxxx&password=xxxxxx&mobile=9665xxxxxx&unicode=E&message=test) from Malath sms&amp;sender=your sender name here\]([http://sms.malath.net.sa/httpSmsProvider.aspx?username=xxxxxx&amp;password=xxxxxx&amp;mobile=9665xxxxxx&amp;unicode=E&amp;message=test](http://sms.malath.net.sa/httpSmsProvider.aspx?username=xxxxxx&password=xxxxxx&mobile=9665xxxxxx&unicode=E&message=test) from Malath sms&amp;sender=your sender name here)

URL for Multiple SMS service \[[http://sms.malath.net.sa/httpSmsProvider.aspx?username=xxxxxx&amp;password=xxxxxx&amp;mobile=9665xxxxxx,9665xxxxxx&amp;unicode=E&amp;message=](http://sms.malath.net.sa/httpSmsProvider.aspx?username=xxxxxx&password=xxxxxx&mobile=9665xxxxxx,9665xxxxxx&unicode=E&message=) test from Malath sms&amp;sender=your sender name here\]([http://sms.malath.net.sa/httpSmsProvider.aspx?username=xxxxxx&amp;password=xxxxxx&amp;mobile=9665xxxxxx,9665xxxxxx&amp;unicode=E&amp;message=](http://sms.malath.net.sa/httpSmsProvider.aspx?username=xxxxxx&password=xxxxxx&mobile=9665xxxxxx,9665xxxxxx&unicode=E&message=) test from Malath sms&amp;sender=your sender name here)

In this URL for sending on multiple mobile you have to separate with comma(,)

Note: must be active your sender name before do any test.

HTTP Parameters
===============

[](#http-parameters)

Username: This is your account username given by Malath SMS

Password: this is password of your account Mobile: This is

recipient mobile number. Format should be like 9665xxxxxx

Unicode: This is the code which represents type of message. The

values will be E for English, U for Unicode. Describe....

Message: Actual message. If this English it will be English. For

sending Unicode, you need to convert into hexacode.

Sender: This is sender address. This can be only in English and only

up to 11characters.

Return Codes

### 0

[](#0)

```
Success

```

### 101

[](#101)

```
Parameter are missing

```

### 104

[](#104)

```
either user name or password are missing or your Account is on hold

```

### 105

[](#105)

```
Credit are not available

```

### 106

[](#106)

```
wrong Unicode

```

### 107

[](#107)

```
blocked sender name

```

### 108

[](#108)

```
missing sender name

```

C- Balance query:

If you want to know your balance after sending SMS, you can follow

these steps:

1 - Replace the variables in this following link with the suitable

values, and then open it via the browser or any other programming

language.

URL for Balance Query service [http://sms.malath.net.sa/api/getBalance.aspx?username=xxxxxx&amp;password=xxxxxxxx](http://sms.malath.net.sa/api/getBalance.aspx?username=xxxxxx&password=xxxxxxxx)

Return Codes

Error~ There is a wrong content in the link

Error~ You have not a permission to or your account info is incorrect

D- Send Scheduled Message:

Send Scheduled Message the formate of date and time

date=25/12/2010 , time=18:00 , unicode = U for unicode arabic

and E for English

URL for Send Scheduled Message service in English [http://sms.malath.net.sa/apis/users.aspx?code=8&amp;username=xxxx&amp;password=xxxx&amp;](http://sms.malath.net.sa/apis/users.aspx?code=8&username=xxxx&password=xxxx&)mobile=9665xxxxxx&amp;sender=SMS&amp;Date= 28 / 12 /2011&amp;Time=13:00&amp;message=Hi&amp;u nicode=E

URL for Send Scheduled Message service in ARABIC [http://sms.malath.net.sa/apis/users.aspx?code=8&amp;username=xxxxx&amp;password=xxx&amp;](http://sms.malath.net.sa/apis/users.aspx?code=8&username=xxxxx&password=xxx&)mobile=9665xxxxxx&amp;sender=SMS&amp;Date= 28 / 12 /2011&amp;Time=13:00&amp;message=062A 062C063106280647002006450646002006450648064206390020062C064806270644&amp;unicode=U

```
In this URL for sending on multiple mobile you have to separate with comma(,)

```

Note: must be active your sender name before do any test.

Return Codes

```
Success 3101

```

```
Parameter are missing 101

```

```
either user name or password are missing or your Account is on hold 104

```

```
Credit are not available 105

```

```
wrong Unicode 106

```

```
blocked sender name 107

```

```
missing sender name 108

```

```
Block Keyword 109

```

E- Insert Main Group:

Add Main Group in your Account throw API.

URL for Add Main Group [http://sms.malath.net.sa/apis/users.aspx?code=4&amp;username=xxxx&amp;password=xxxx&amp;](http://sms.malath.net.sa/apis/users.aspx?code=4&username=xxxx&password=xxxx&)main=MainGroupname

Return Codes

```
3101
Success

```

### 3102

[](#3102-1)

```
Wrong Password

```

### 3103

[](#3103-1)

```
User Name Don’t Exist

```

### 3104

[](#3104-1)

```
Account Inactive

```

### 3105

[](#3105-1)

```
Missing Parameter

```

### 3911

[](#3911)

```
Add Group Successive

```

```
Add Group Failed 3914

```

F- Insert Sub Group:

Add Sub Group in your Account throw API.

URL for Add Sub Group [http://sms.malath.net.sa/apis/users.aspx?code=5&amp;username=xxxx&amp;password=xxxx&amp;](http://sms.malath.net.sa/apis/users.aspx?code=5&username=xxxx&password=xxxx&)main=MainGroupID&amp;sub=SubGroupName

Return Codes

```
3101
Success

```

### 3102

[](#3102-2)

```
Wrong Password

```

### 3103

[](#3103-2)

```
User Name Don’t Exist

```

### 3104

[](#3104-2)

```
Account Inactive

```

### 3105

[](#3105-2)

```
Missing Parameter

```

### 3911

[](#3911-1)

```
Add Group Successive

```

```
Add Group Failed 3914

```

```
Wrong Main Group 3913

```

G- Add Contact to Group:

You can add Contact to your group easily throw API.

URL for Add Contact to Group [http://sms.malath.net.sa/apis/users.aspx?code=6&amp;username=xxxx&amp;password=xxxx&amp;](http://sms.malath.net.sa/apis/users.aspx?code=6&username=xxxx&password=xxxx&)name=Ahmad,Subhi,Khaled&amp;number=9665555xxx,96659787xxx,9665554544xxx&amp;s ub=

Return Codes

### 3101

[](#3101-1)

```
Success

```

### 3102

[](#3102-3)

```
Wrong Password

```

### 3103

[](#3103-3)

```
User Name Don’t Exist

```

### 3104

[](#3104-3)

```
Account Inactive

```

### 3105

[](#3105-3)

```
Missing Parameter

```

### 3333

[](#3333)

```
Missing Contact Number Or Contact Name

```

H - Add Sender Name:

You can add Sender name to your account easily throw API.

```
URL for Check User Name and Password
http://sms.malath.net.sa/apis/users.aspx?code= 2 &username=xxx&password=xxxx&
newsender=xxxxxx

```

Return Codes

```
Success 3101

```

```
Wrong Password 3102

```

```
User Name Don’t Exist 3103

```

```
Account Inactive 3104

```

```
Missing Parameter 3105

```

```
Sender Name Violation Rule 443

```

```
Time Out Operation 3405

```

```
Sender Name Received 143

```

```
Sender Name exist 444

```

I - Review Sender Names:
------------------------

[](#i---review-sender-names)

You can Review your Sender name easily throw API.

```
URL for Check User Name and Password
http://sms.malath.net.sa/apis/users.aspx?code= 9 &username=xxx&password=xxx

```

Return Codes

```
Review

```

Success (^) senders Wrong Password 3102 User Name Don’t Exist 3103 Account Inactive 3104 Missing Parameter 3105 Time Out Operation 3405

END
===

[](#end)

###  Health Score

26

—

LowBetter than 43% of packages

Maintenance13

Infrequent updates — may be unmaintained

Popularity20

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity50

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~0 days

Total

4

Last Release

2875d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/a9e5287358c59c776ad8b32d5ff9669f23320d091ff47e466cbb72e46c608b6e?d=identicon)[vzool](/maintainers/vzool)

---

Top Contributors

[![vzool](https://avatars.githubusercontent.com/u/4952736?v=4)](https://github.com/vzool "vzool (12 commits)")

---

Tags

malathmalath-smsphp-librarysmssms-api

### Embed Badge

![Health badge](/badges/vzool-malath-sms/health.svg)

```
[![Health](https://phpackages.com/badges/vzool-malath-sms/health.svg)](https://phpackages.com/packages/vzool-malath-sms)
```

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
