Balance Inquiry

  1. Home
  2. Developer Center
  3. Balance Inquiry

Introduction

Last Update: 26th October 2023

The Balance Inquiry API allow to check your account balance in real time. Whether you are an individual user or an enterprise, keeping track of your available SMS credits is essential for managing your messaging campaigns effectively. This guide provides an overview of the Balance Inquiry API, including its key features, how to use it, and examples for integration.

Balance Inquiry Request

To check account balance, all POST / GET request shall be submitted to following URL:
Actual working example with optional parameters:
Below table explanation for all Parameters:
# Parameter Description Mandatory Example
1 user APP_KEY capture from Configurations > APIs > Create Connection Yes 7LrdwRb1Ya
2 pass APP_SECRET capture from Configurations > APIs > Create Connection Yes aAjc9I7mW5eGzxwYs
3 country Optional parameter
The value shows with the current balance, the remaining total SMS can be sent in particular country.

The provided value must be alpha-3 country code
eg. 'MYS' or 'CHN' 		No MYS
* All parameters must be encoded in URL format if API triggered via GET Request
Following sample source code in different languages: 
<?php

class bulk360{
    var $user   = 'API_KEY';
    var $pass   = 'API_SECRET';
    var $from   = '66688';
    var $to;
    var $text;

    var $url            = 'https://sms.360.my/gw/bulk360/v3_0/send.php';
    var $balance_url    = 'https://sms.360.my/api/balance/v3_0/getBalance';

    function __construct() {
        $this->user = urlencode($this->user);
        $this->pass = urlencode($this->pass);

        $this->url = $this->url . "?user=$this->user&pass=$this->pass&from=$this->from";
    }

    function sendsms($to, $text) {
        $this->url = $this->url . "&to=" . $to . "&text=" . rawurlencode($text);

        $ch = curl_init();
        curl_setopt($ch, CURLOPT_URL, $this->url);
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
        curl_setopt($ch, CURLOPT_FOLLOWLOCATION, 1);
        curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);
        $sentResult = curl_exec($ch);
        if ($sentResult == FALSE) {
            echo 'Curl failed for sending sms to bulk360.. '.curl_error($ch);
        }
        curl_close($ch);

        echo 'sentResult = ' . $sentResult;
    }

    function checkBalance($country = "") {
        $country = ($country) ? "?country="  . $country : "";
        $this->balance_url = $this->balance_url . $country;

        $ch = curl_init();
        curl_setopt($ch, CURLOPT_URL, $this->url);
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
        curl_setopt($ch, CURLOPT_FOLLOWLOCATION, 1);
        curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);
        $balanceResult = curl_exec($ch);
        if ($balanceResult == FALSE) {
            echo 'Curl failed for balance checking in bulk360.. '.curl_error($ch);
        }
        curl_close($ch);

        echo 'balanceResult = ' . $balanceResult;
    }
}

$sms = new bulk360();
$sms->sendsms('60123240066', 'This is a test message from Bulk360');
$sms->checkBalance('MYS');

?>
Download Source 
<?php

class bulk360{
    var $user   = 'API_KEY';
    var $pass   = 'API_SECRET';
    var $from   = '66688';
    var $to;
    var $text;

    var $url    = 'https://sms.360.my/gw/bulk360/v3_0/send.php';

    function __construct() {
        $this->user = urlencode($this->user);
        $this->pass = urlencode($this->pass);

        $this->url = $this->url . "?user=$this->user&pass=$this->pass&from=$this->from";
    }

    function sendsms($to, $text) {
        $text = urlencode($text);
        $this->url = $this->url . "&to=$to&text=$text";

        $response = file_get_contents($this->url);
        echo 'this->url = ' . $this->url . '<br />';
        echo 'response = ' . $response;
    }
}

$sms = new bulk360();
$sms->sendsms('60123240066', 'This is a test message from Bulk360');

?>
Download Source 
Imports System.Net
Imports System.IO

Partial Public Class _Default
    Inherits System.Web.UI.Page

    Protected Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Load

    End Sub

    Protected Sub Send2Btn_Click(ByVal sender As Object, ByVal e As EventArgs) Handles Send2Btn.Click
        Dim resultCode As [String] = ""
        Dim balanceResult As [String] = ""
        'Following are working sample, you may provide the correct user access details and phone no to test
        '1. user - API_KEY
        '2. pass - API_SECRET
        '3. to - Phone no, ex. 6012xxxyyyy

        Dim request As WebRequest = WebRequest.Create("https://sms.360.my/gw/bulk360/v3_0/send.php?user=admin&pass=12345&to=60123240066&from=admin&text=test%20message%20on%2024/03/2016")
        Using GWresponse As WebResponse = request.GetResponse()
            Using stream As New StreamReader(GWresponse.GetResponseStream())
                resultCode = stream.ReadLine
            End Using
        End Using
        Label1.Text = "Result Code: " & resultCode

        Dim request As WebRequest = WebRequest.Create("https://sms.360.my/api/balance/v3_0/getBalance?user=admin&pass=12345&country=MYS")
        Using GWresponse As WebResponse = request.GetResponse()
            Using stream As New StreamReader(GWresponse.GetResponseStream())
                balanceResult = stream.ReadLine
            End Using
        End Using
        Label2.Text = "Balance: " & balanceResult
    End Sub

End Class
Download Source 
<form method="get" action="https://sms.360.my/gw/bulk360/v3_0/send.php">
    <table>
        <tr>
            <td>
                Username (API_KEY):
            </td>
            <td>
                <input type="text" id="user" name="user" />
            </td>
        </tr>
        <tr>
            <td>
                Password (API_SECRET):
            </td>
            <td>
                <input type="text" id="pass" name="pass" />
            </td>
        </tr>
        <tr>
            <td>
                To:
            </td>
            <td>
                <input type="text" id="to" name="to" />
            </td>
        </tr>
        <tr>
            <td>
                From:
            </td>
            <td>
                <input type="text" id="from" name="from" />
            </td>
        </tr>
        <tr>
            <td>
                Text:
            </td>
            <td>
                <input type="text" id="text" name="text" />
            </td>
        </tr>
        <tr>
            <td colspan="2">
                <input type="submit" value="Submit Now" />
            </td>
        </tr>
    </table> 
</form>
Launch Sample Form Download Source

If parameter country='MYS' is provided, the API will return 4 values as specified in HTTP Response
If country='MYS' is not provided, the API will only return 2 values without Currency and Account Balance

HTTP Response

Upon the Balance Inquiry API is called, the API will return 4 values:
  • status - The real-time request status, refer to following table Response Code
  • description - Result of the request
  • currency - Currency of your account
  • balance - Balance amount in above currency
  • optional - [with parameter 'country=MYS']
    • country - Country provided
    • credits - Available sms credits to send in particular country

Note that due to SMS are queued for process later, the return Balance is not included the charges that's going to incur later.

Response Code Description
success OK
400 Missing parameters or invalid field type
401 Invalid Username or password
403 Message API not enabled, requested IP not whitelisted or not enabled
Example of a wrong APP_KEY and APP_SECRET combination:
{
    "status"         : 401,
    "description"    : "Invalid Username or password"
}
Example of a successful response for balance inquiry request:
{
    "status"             : success,
    "description"        : {
        "currency"           : "MYR",
        "balance"            : "935.0378",
    }
}
Example of a successful response for balance inquiry request (with country='MYS'):
{
    "status"             : success,
    "description"        : {
        "currency"           : "MYR",
        "balance"            : "935.0378",
        "country"            : "MYS"
        "credits"            : 11402,
    }
}
Example of a missing any mandatory field(s):
{
    "status": 400,
    "description": "Missing parameters or invalid field type"
}
mode_edit