Octane REST API
  1. Mobile
Octane REST API
  • Getting Started
    • API Access & Authentication
    • API Rate Limiting
  • Integration Guides
    • Payment Integration
    • CDR Integration
    • Test Environment Data Sets
    • Mobile Flows
      • Activate Postpaid Mobile (New MSN - Physical SIM)
      • Activate Postpaid (Port MSN - Physical SIM)
      • Activate Postpaid Mobile (New MSN - eSIM)
      • Activate Postpaid (Port MSN - eSIM)
      • Reset eSIM Profile
      • Mobile Data Pool Flow
    • ConnectYou Flows
      • ConnectYou Business SIP Trunk Activate Flow
      • ConnectYou Business SIP Trunk Reactivate Direct Indials Flow
      • ConnectYou Unite Calling Activate Flow
    • NBN Flows
      • NBN Activate Flow
      • NBN Plan Change Flow
      • NBN Termination Flow
      • NBN Reschedule Appointment Flow
      • NBN Withdraw Order Flow
      • Run NBN Diagnostic Test Flow
      • Run NBN Service Health Check Flow
  • API Documentation
    • Customer
      • Add Customer
      • Get Customer Detail
      • List Customers
      • Update Customer
      • Set Customer Direct Debit
      • Send Welcome Email
    • Payment Method
      • List Payment Methods
      • Add Payment Method
      • Update Payment Method
      • Delete Payment Method
    • Transaction
      • List Transactions
      • Make Payment
      • Add Misc Adjustment
      • List Bounced Transactions
    • Plan
    • Service
      • List Services for a Customer
      • Get Service Detail by LineSeqNo
    • Mobile
      • Notification
        • Get Notification Settings
        • Update Notification Settings
      • Get Data Pool
      • Update Data Limit
      • Transfer Services to Another Pool
      • Disconnect a Data Pool
      • Get eSIM Details
      • Manage eSIM
    • Address
      • Search for an Address
      • Search for an Address V2
    • Service Qualification
      • Perform Service Qualification Check
    • Order
      • v1
        • Create Order (NBN Activation)
        • Create Order (NBN Modification)
        • Create Order (NBN Disconnection)
        • Cancel (NBN Activation) Order
        • Get Order Detail (NBN)
        • List Orders (NBN)
    • Enquiry
      • Create Enquiry (NBN Diagnostic Test / Service Health Check)
      • Get Enquiry Detail
      • List Enquiries
    • Appointment
      • Query Appointment Timeslots
      • Book Appointment
    • NBN
      • Get Available Diagnostic Tests
    • Attachment
  • API Documentation (Legacy APIs)
    • WSDL Summary
    • API Guide
      • Account Charges
        • Add a Recurring Charge
        • Get Recurring Charge Details
        • Add a Manual Charge
      • ConnectYou
        • Create a Number Reservation
        • Get Available Numbers
        • queryResiEndPointService
        • Query a Business SIP Trunk Service
        • Get Zone Detail
        • Get Number Detail
      • Contact Log
        • Get Contact Log Types
        • Add a Contact Log
        • Update a Contact Log
        • Query Contact Logs
      • Device
        • getSupplierStockDetail
        • getSupplierProduct
        • getSupplierFreightOption
        • orderDevice
      • Mobile
        • Get Mobile Provisioning Product Catalogue
          POST
        • Query a Mobile Service
          POST
        • Query Mobile Add Ons
          POST
        • Query Mobile Feature Settings
          POST
        • Query Mobile Balance
          POST
      • Notifications
        • createNotification
        • notificationManageTemplate
      • Pooled Resource
        • Reserve a Resource
        • Unreserve a Resource
        • Select a Resource
        • Query Resource
      • Order
        • Mobile Order
          • Create a Mobile Service (New Number)
          • Create a Mobile Service (Port In Number)
          • Create a Pre-Activation Mobile Order (New Number)
          • Bar/Unbar/Disconnect a Mobile Service
          • Change Mobile Rate Plan
          • Change a Mobile Number
          • Replace a SIM Card
          • Modify Mobile Feature(s)
          • Modify Mobile Feature Setting(s)
          • Change Excess Spend Limit
          • Add a Once-off Bolt On
          • Add a Recurring Bolt On Pack
          • Remove a Recurring Bolt On Pack
        • Mobile (Data Pool) Order
          • Create a Data Pool
          • Add Consumers to Data Pool
          • Remove Consumers from Data Pool
        • ConnectYou (SIP Trunk) Order
          • Create a New Business SIP Trunk
          • Bar/Unbar International Calls on a Business SIP Trunk
          • Suspend Business SIP Trunk
          • Unsuspend Business SIP Trunk
          • Deactivate Business SIP Trunk
          • Port Numbers to a Business SIP Trunk
          • Configure Business SIP Trunk
        • Other Rated Order
          • Create an Other Rated Service
          • Change Access of an Other Rated Service
        • Create an Order
        • Cancel an Order
        • Query an Order
        • Reset an Order
      • Statements & Billing
        • Get a List of Customer Bills
        • Get Charge Item Detail for a Bill
        • Get a Single Bill PDF for a Customer
        • Get a Summary of a Bill
      • Unbilled Calls
        • Query Summary of Unbilled Calls & Charges
        • Query Detail of Unbilled Calls & Charges
      • OTP
        • Manage OTP (Get & Verify OTP)
    • Reference Data
  1. Mobile

Query Mobile Balance

Testing Env
https://benzine.telcoinabox.com/tiab
Testing Env
https://benzine.telcoinabox.com/tiab
POST
https://benzine.telcoinabox.com/tiab
/UtbMobile
mobile

UtbMobile:queryBalanceV3#

This service is to be exposed by the Octane application. This service will be used by external systems such as the Service Provider and other Telcoinabox systems/sites to check the balances left and view the amount used for a period as well as the included amount for call spend allowance for an active 4G mobile service in Octane.
This Octane service will be exposed as a SOAP message via the UtbMobile WSDL.

Request

Authorization
Send your HTTP requests with an
Authorization
header that contains the word Basic followed by a space and a base64-encoded string username:password
Example:
Authorization: Basic *****************
Header Params
Content-Type
string 
required
Example:
text/xml; charset=utf-8
Body Params application/xml
Body
object 
required
queryBalanceV3
object 
required
Example
<?xml version="1.0" encoding="UTF-8"?>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
  <soapenv:Body>
    <mob:queryBalanceV3 xmlns:mob="http://mobileservice.frontend.ws.utilibill.com.au/">
      <login>
        <userName>username</userName>
        <password>password</password>
      </login>
      <queryBalanceRequest>
        <custNo>383656</custNo>
        <lineSeqNo>519</lineSeqNo>
      </queryBalanceRequest>
    </mob:queryBalanceV3>
  </soapenv:Body>
</soapenv:Envelope>

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://benzine.telcoinabox.com/tiab/UtbMobile' \
--header 'Content-Type: text/xml; charset=utf-8' \
--header 'Authorization: Basic Og==' \
--data-raw '<?xml version="1.0" encoding="UTF-8"?>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
  <soapenv:Body>
    <mob:queryBalanceV3 xmlns:mob="http://mobileservice.frontend.ws.utilibill.com.au/">
      <login>
        <userName>username</userName>
        <password>password</password>
      </login>
      <queryBalanceRequest>
        <custNo>383656</custNo>
        <lineSeqNo>519</lineSeqNo>
      </queryBalanceRequest>
    </mob:queryBalanceV3>
  </soapenv:Body>
</soapenv:Envelope>'

Responses

🟢200queryBalanceV3 response
application/xml
Body
Body
object 
required
queryBalanceV3Response
object 
required
Examples
<?xml version='1.0' encoding='UTF-8'?>
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
    <SOAP-ENV:Header />
    <S:Body>
        <ns2:queryBalanceV3Response xmlns:ns2="http://mobileservice.frontend.ws.utilibill.com.au/">
            <return>
                <success>true</success>
                <errorCode>0</errorCode>
                <queryItems>
                    <accountDesc>5GB Recurring Bolt-on</accountDesc>
                    <accountId>8050540</accountId>
                    <accountType>Dedicated Account</accountType>
                    <allowance>false</allowance>
                    <creditValue>0.0</creditValue>
                    <creditValueFmt>0</creditValueFmt>
                    <expDate>2024-02-27T23:00:00.000+1100</expDate>
                    <offerId>80505</offerId>
                    <pair>false</pair>
                    <startDate>2024-02-19T23:00:00.000+1100</startDate>
                    <unitCode>Data</unitCode>
                </queryItems>
                <queryItems>
                    <accountDesc>Unlimited Bolt-on 2</accountDesc>
                    <accountId>8056720</accountId>
                    <accountType>Dedicated Account</accountType>
                    <allowance>false</allowance>
                    <creditValue>1.0</creditValue>
                    <creditValueFmt>1</creditValueFmt>
                    <currency>AUD</currency>
                    <expDate>2024-02-27T23:00:00.000+1100</expDate>
                    <offerId>80567</offerId>
                    <pair>false</pair>
                    <startDate>2024-02-19T23:00:00.000+1100</startDate>
                    <unitCode>Money</unitCode>
                </queryItems>
                <queryItems>
                    <accountDesc>2GB Auto Block Data</accountDesc>
                    <accountId>8056940</accountId>
                    <accountType>Dedicated Account</accountType>
                    <allowance>false</allowance>
                    <creditValue>0.0</creditValue>
                    <creditValueFmt>0</creditValueFmt>
                    <expDate>2024-02-27T23:00:00.000+1100</expDate>
                    <offerId>80569</offerId>
                    <pair>false</pair>
                    <startDate>2024-02-19T23:00:00.000+1100</startDate>
                    <unitCode>Data</unitCode>
                </queryItems>
                <queryItems>
                    <accountDesc>IDD Calling Pack 120MINS</accountDesc>
                    <accountId>8057120</accountId>
                    <accountType>Dedicated Account</accountType>
                    <allowance>false</allowance>
                    <creditValue>0.0</creditValue>
                    <creditValueFmt>0</creditValueFmt>
                    <expDate>2024-02-27T23:00:00.000+1100</expDate>
                    <offerId>80571</offerId>
                    <pair>false</pair>
                    <startDate>2024-02-19T23:00:00.000+1100</startDate>
                    <unitCode>Duration</unitCode>
                </queryItems>
                <queryItems>
                    <accountDesc>IDD Calling Pack 300MINS</accountDesc>
                    <accountId>8057320</accountId>
                    <accountType>Dedicated Account</accountType>
                    <allowance>false</allowance>
                    <creditValue>0.0</creditValue>
                    <creditValueFmt>0</creditValueFmt>
                    <expDate>2024-02-27T23:00:00.000+1100</expDate>
                    <offerId>80573</offerId>
                    <pair>false</pair>
                    <startDate>2024-02-19T23:00:00.000+1100</startDate>
                    <unitCode>Duration</unitCode>
                </queryItems>
                <queryItems>
                    <accountDesc>Excess usage</accountDesc>
                    <accountId>8060000</accountId>
                    <accountType>Dedicated Account</accountType>
                    <allowance>false</allowance>
                    <creditValue>5000.0</creditValue>
                    <creditValueFmt>5000</creditValueFmt>
                    <currency>AUD</currency>
                    <offerId>80650</offerId>
                    <pair>false</pair>
                    <unitCode>Money</unitCode>
                </queryItems>
                <queryItems>
                    <accountDesc>1GB Excess Data</accountDesc>
                    <accountId>8065140</accountId>
                    <accountType>Dedicated Account</accountType>
                    <allowance>false</allowance>
                    <creditValue>0.0</creditValue>
                    <creditValueFmt>0</creditValueFmt>
                    <expDate>2024-02-27T23:00:00.000+1100</expDate>
                    <offerId>80651</offerId>
                    <pair>false</pair>
                    <startDate>2024-02-19T23:00:00.000+1100</startDate>
                    <unitCode>Data</unitCode>
                </queryItems>
                <queryItems>
                    <accountDesc>IR AP Travel Pack 1 provisioning counter</accountDesc>
                    <accountId>8057680</accountId>
                    <accountType>Dedicated Account</accountType>
                    <allowance>false</allowance>
                    <creditValue>150.0</creditValue>
                    <creditValueFmt>150</creditValueFmt>
                    <currency>AUD</currency>
                    <expDate>2024-02-27T23:00:00.000+1100</expDate>
                    <offerId>80957</offerId>
                    <pair>false</pair>
                    <startDate>2024-02-19T23:00:00.000+1100</startDate>
                    <unitCode>Money</unitCode>
                </queryItems>
                <queryItems>
                    <accountDesc>120GB - 5G Plan Data Allowance</accountDesc>
                    <accountId>8096040</accountId>
                    <accountType>Dedicated Account</accountType>
                    <allowance>false</allowance>
                    <creditValue>1.2884901888E11</creditValue>
                    <creditValueFmt>128849018880</creditValueFmt>
                    <expDate>2024-02-27T23:00:00.000+1100</expDate>
                    <offerId>80960</offerId>
                    <pair>false</pair>
                    <startDate>2024-02-19T23:00:00.000+1100</startDate>
                    <unitCode>Data</unitCode>
                </queryItems>
                <queryItems>
                    <accountDesc>DataBank</accountDesc>
                    <accountId>8099840</accountId>
                    <accountType>Dedicated Account</accountType>
                    <allowance>false</allowance>
                    <creditValue>0.0</creditValue>
                    <creditValueFmt>0</creditValueFmt>
                    <expDate>2024-02-27T23:00:00.000+1100</expDate>
                    <offerId>80998</offerId>
                    <pair>false</pair>
                    <startDate>2024-02-19T23:00:00.000+1100</startDate>
                    <unitCode>Data</unitCode>
                </queryItems>
                <balances>
                    <balance>
                        <type>DATA</type>
                        <subType>BANK</subType>
                        <allowance>5.36870912E11</allowance>
                        <allowanceFmt>536870912000</allowanceFmt>
                        <balance>0.0</balance>
                        <balanceFmt>0</balanceFmt>
                        <used>5.36870912E11</used>
                        <usedFmt>536870912000</usedFmt>
                        <unit>Data</unit>
                        <balanceDesc>DataBank</balanceDesc>
                    </balance>
                    <balance>
                        <type>VOICE_MSG</type>
                        <subType>CORE</subType>
                        <allowance>150.0</allowance>
                        <allowanceFmt>150</allowanceFmt>
                        <balance>150.0</balance>
                        <balanceFmt>150</balanceFmt>
                        <used>0.0</used>
                        <usedFmt>0</usedFmt>
                        <unit>Money</unit>
                        <balanceDesc>IR AP Travel Pack 1 provisioning counter</balanceDesc>
                    </balance>
                    <balance>
                        <type>DATA</type>
                        <subType>CORE</subType>
                        <allowance>1.2884901888E11</allowance>
                        <allowanceFmt>128849018880</allowanceFmt>
                        <balance>1.2884901888E11</balance>
                        <balanceFmt>128849018880</balanceFmt>
                        <used>0.0</used>
                        <usedFmt>0</usedFmt>
                        <unit>Data</unit>
                        <balanceDesc>120GB - 5G Plan Data Allowance</balanceDesc>
                    </balance>
                    <balance>
                        <type>VOICE_MSG</type>
                        <subType>RECURRING</subType>
                        <allowance>1.0</allowance>
                        <allowanceFmt>1</allowanceFmt>
                        <balance>1.0</balance>
                        <balanceFmt>1</balanceFmt>
                        <used>0.0</used>
                        <usedFmt>0</usedFmt>
                        <unit>Money</unit>
                        <balanceDesc>Unlimited Bolt-on 2</balanceDesc>
                    </balance>
                    <balance>
                        <type>DATA</type>
                        <subType>RECURRING</subType>
                        <allowance>1.073741824E10</allowance>
                        <allowanceFmt>10737418240</allowanceFmt>
                        <balance>0.0</balance>
                        <balanceFmt>0</balanceFmt>
                        <used>1.073741824E10</used>
                        <usedFmt>10737418240</usedFmt>
                        <unit>Data</unit>
                        <balanceDesc>2GB Auto Block Data</balanceDesc>
                    </balance>
                    <balance>
                        <type>VOICE</type>
                        <subType>RECURRING</subType>
                        <allowance>7200.0</allowance>
                        <allowanceFmt>7200</allowanceFmt>
                        <balance>0.0</balance>
                        <balanceFmt>0</balanceFmt>
                        <used>7200.0</used>
                        <usedFmt>7200</usedFmt>
                        <unit>Duration</unit>
                        <balanceDesc>IDD Calling Pack 120MINS</balanceDesc>
                    </balance>
                    <balance>
                        <type>VOICE</type>
                        <subType>RECURRING</subType>
                        <allowance>18000.0</allowance>
                        <allowanceFmt>18000</allowanceFmt>
                        <balance>0.0</balance>
                        <balanceFmt>0</balanceFmt>
                        <used>18000.0</used>
                        <usedFmt>18000</usedFmt>
                        <unit>Duration</unit>
                        <balanceDesc>IDD Calling Pack 300MINS</balanceDesc>
                    </balance>
                    <balance>
                        <type>VOICE_MSG</type>
                        <subType>RECURRING</subType>
                        <allowance>2000.0</allowance>
                        <allowanceFmt>2000</allowanceFmt>
                        <balance>5000.0</balance>
                        <balanceFmt>5000</balanceFmt>
                        <used>-3000.0</used>
                        <usedFmt>-3000</usedFmt>
                        <unit>Money</unit>
                        <balanceDesc>Excess usage</balanceDesc>
                    </balance>
                    <balance>
                        <type>DATA</type>
                        <subType>TOPUP</subType>
                        <allowance>3.6870912E8</allowance>
                        <allowanceFmt>368709120</allowanceFmt>
                        <balance>0.0</balance>
                        <balanceFmt>0</balanceFmt>
                        <used>3.6870912E8</used>
                        <usedFmt>368709120</usedFmt>
                        <unit>Data</unit>
                        <balanceDesc>5GB Recurring Bolt-on</balanceDesc>
                    </balance>
                    <balance>
                        <type>DATA</type>
                        <subType>TOPUP</subType>
                        <allowance>1.073741824E9</allowance>
                        <allowanceFmt>1073741824</allowanceFmt>
                        <balance>0.0</balance>
                        <balanceFmt>0</balanceFmt>
                        <used>1.073741824E9</used>
                        <usedFmt>1073741824</usedFmt>
                        <unit>Data</unit>
                        <balanceDesc>1GB Excess Data</balanceDesc>
                    </balance>
                </balances>
            </return>
        </ns2:queryBalanceV3Response>
    </S:Body>
</S:Envelope>
🔴500queryBalanceV3 fault - InvalidLoginException
🔴500queryBalanceV3 fault - InvalidParameterException
🔴500queryBalanceV3 fault - ProcessingException
Modified at 2024-05-08 02:25:55
Previous
Query Mobile Feature Settings
Next
createNotification
Built with