Go to full article


Overview

The Get Usage Per Day API provides a break down of usage per service subscription, per day. It will present usage for both telephony and data service types.

This operation will only display usage for periods that have not been closed.

Obtaining the usage for a service subscription

To obtain a break down of usage per service subscription period:

  1. Create a GetUsagePerDay request
  2. Specify service subscription period ID

WSDL

https://api.emersion.com.au/Services.wsdl

Operation name

GetUsagePerDay 



Business Rules

The service subscription period must be current. This will not work for a service subscription period that has been closed.

This only supports services that are telephony or data (eg RADIUS) based.

Bolt-ons and Data bolt-ons are supported and will be presented as a separate elements.




SOAP Example

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:emersion:api">
   <soapenv:Header/>
   <soapenv:Body>
      <urn:GetUsagePerDayRequest>
         <urn:ServiceSubscriptionPeriodID>29225998</urn:ServiceSubscriptionPeriodID>
      </urn:GetUsagePerDayRequest>
   </soapenv:Body>
</soapenv:Envelope>




Field Descriptions

All field names are case sensitive. Check enumerated values in the descriptions to confirm capitalisation and spacing. See field types for additional information..

NameDescriptionRequired?Field Type

Character

limit

Values 
ServiceSubscriptionPeriodID
The service subscription period ID in question.YesNumber28

A valid service subscription period.



Error Handling

Error MessageDescription
Invalid Service Subscription IDThis will occur when the supplied service subscription period doesn't exist, or is not part of a service subscription owned by one of your accounts.




Reference Data 

Alternative Locations

Service subscription periods can be obtained via the customer page and then Service Subscriptions > Service Subscription Periods sub tab.