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 Add Ons

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

UtbMobile:queryServiceAddons#

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 enquire on the excess spend limit(s) 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
queryServiceAddOns
object 
required
Example
<?xml version="1.0" encoding="UTF-8"?>
<soapenv:Envelope xmlns:mob="http://mobileservice.frontend.ws.utilibill.com.au/" xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
  <soapenv:Body>
    <mob:queryServiceAddOns>
      <login>
        <userName>username</userName>
        <password>password</password>
      </login>
      <wmeQueryAddOnsRequest>
        <custNo>383656</custNo>
        <lineSeqNo>519</lineSeqNo>
      </wmeQueryAddOnsRequest>
    </mob:queryServiceAddOns>
  </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:mob="http://mobileservice.frontend.ws.utilibill.com.au/" xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
  <soapenv:Body>
    <mob:queryServiceAddOns>
      <login>
        <userName>username</userName>
        <password>password</password>
      </login>
      <wmeQueryAddOnsRequest>
        <custNo>383656</custNo>
        <lineSeqNo>519</lineSeqNo>
      </wmeQueryAddOnsRequest>
    </mob:queryServiceAddOns>
  </soapenv:Body>
</soapenv:Envelope>'

Responses

🟢200queryServiceAddOns response
application/xml
Body
Body
object 
required
queryServiceAddOnsResponse
object 
required
Example
<?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:queryServiceAddOnsResponse xmlns:ns2="http://mobileservice.frontend.ws.utilibill.com.au/">
            <return>
                <success>true</success>
                <errorCode>0</errorCode>
                <addOns>
                    <addOn>
                        <contractId>CONTR0000168556</contractId>
                        <spendCode>80568</spendCode>
                        <description>MSS-80568-Unlimited Bolt-on 2</description>
                        <name>MSS-80568-Unlimited Bolt-on 2</name>
                        <snCode>3862</snCode>
                        <addOnItems>
                            <addOnItem>
                                <validFrom>2024-02-19T15:15:06+11:00</validFrom>
                                <validTo>9999-12-31T00:00:00+11:00</validTo>
                                <status>0</status>
                                <seqNo>3</seqNo>
                            </addOnItem>
                        </addOnItems>
                    </addOn>
                    <addOn>
                        <contractId>CONTR0000168556</contractId>
                        <spendCode>80620</spendCode>
                        <description>MSS-80620-$100 Excess Limit</description>
                        <name>MSS-80620-$100 Excess Limit</name>
                        <snCode>856</snCode>
                        <addOnItems>
                            <addOnItem>
                                <validFrom>2024-02-19T15:12:17+11:00</validFrom>
                                <validTo>9999-12-31T00:00:00+11:00</validTo>
                                <status>0</status>
                                <seqNo>2</seqNo>
                            </addOnItem>
                        </addOnItems>
                    </addOn>
                    <addOn>
                        <contractId>CONTR0000168556</contractId>
                        <spendCode>80650</spendCode>
                        <description>MSS-80650-$5000 Excess Limit</description>
                        <name>MSS-80650-$5000 Excess Limit</name>
                        <snCode>859</snCode>
                        <addOnItems>
                            <addOnItem>
                                <validFrom>2024-02-19T00:00:00+11:00</validFrom>
                                <validTo>2024-02-28T00:00:00+11:00</validTo>
                                <status>0</status>
                                <seqNo>1</seqNo>
                            </addOnItem>
                        </addOnItems>
                    </addOn>
                    <addOn>
                        <contractId>CONTR0000168556</contractId>
                        <spendCode>80575</spendCode>
                        <description>MSS-80575-IR AP TP1 Base Offer</description>
                        <name>MSS-80575-IR AP TP1 Base Offer</name>
                        <snCode>3898</snCode>
                        <addOnItems>
                            <addOnItem>
                                <validFrom>2024-02-19T15:15:11+11:00</validFrom>
                                <validTo>9999-12-31T00:00:00+11:00</validTo>
                                <status>0</status>
                                <seqNo>4</seqNo>
                            </addOnItem>
                        </addOnItems>
                    </addOn>
                    <addOn>
                        <contractId>CONTR0000168556</contractId>
                        <spendCode>10281</spendCode>
                        <description>Offer check proration validity</description>
                        <name>Offer check proration validity</name>
                        <snCode>2053</snCode>
                        <addOnItems>
                            <addOnItem>
                                <validFrom>2024-02-19T11:57:07+11:00</validFrom>
                                <validTo>9999-12-31T00:00:00+11:00</validTo>
                                <status>0</status>
                            </addOnItem>
                        </addOnItems>
                    </addOn>
                </addOns>
            </return>
        </ns2:queryServiceAddOnsResponse>
    </S:Body>
</S:Envelope>
🔴500queryServiceAddOns fault - InvalidLoginException
🔴500queryServiceAddOns fault - InvalidParameterException
🔴500queryServiceAddOns fault - ProcessingException
Modified at 2024-03-20 07:20:22
Previous
Query a Mobile Service
Next
Query Mobile Feature Settings
Built with