HostedSuite

<back to all web services

ListCallAllowanceBalanceRequest

Retrieves call allowance details for specified client(s) and date range

The following routes are available for this service:
POST/api/call-allowance/balance
ListCallAllowanceBalanceRequest Parameters:
NameParameterData TypeRequiredDescription
StartDatebodystringNoThe start of the date range to list forms for
EndDatebodystringNoThe end of the date range to list forms for
ClientIdbodystringNoThe ID of the client whose balance you want to get
BillHoldbodyboolNoWhether you want to bill for hold time or not
BillTalkbodyboolNoWhether you want to bill for talk time or not
BillTransferbodyboolNoWhether you want to bill for transfer time or not
BillRingbodyboolNoWhether you want to bill for ring time or not
CallRoundingbodyCallRoundingTypeNoRound call durations (Possible values: None, NextMinute, Next30Seconds)
MinCallDurationbodydoubleNoThe minimum duration of the call in seconds (talk time only)
MaxCallDurationbodydoubleNoThe maximum duration of the call in seconds (talk time only)
RequestBase<TResponse> Parameters:
NameParameterData TypeRequiredDescription
CustomerNameformstringYesThe HostedSuite Customer Name
UserNameformstringYesThe HostedSuite User Name. Data visibility and security is based on this user's permissions.
PasswordformstringYesThe HostedSuite User's Password
CallRoundingType Enum:
None
NextMinute
Next30Seconds

To override the Content-type in your clients, use the HTTP Accept Header, append the .xml suffix or ?format=xml

HTTP + XML

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

POST /api/call-allowance/balance HTTP/1.1 
Host: evo.hostedsuite.com 
Accept: application/xml
Content-Type: application/xml
Content-Length: length

<ListCallAllowanceBalanceRequest xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Evo.HostedSuite.Core.ServiceModel">
  <CustomerName>String</CustomerName>
  <Password>String</Password>
  <UserName>String</UserName>
  <BillHold>false</BillHold>
  <BillRing>false</BillRing>
  <BillTalk>false</BillTalk>
  <BillTransfer>false</BillTransfer>
  <CallRounding>None</CallRounding>
  <ClientId>String</ClientId>
  <EndDate>String</EndDate>
  <MaxCallDuration>0</MaxCallDuration>
  <MinCallDuration>0</MinCallDuration>
  <StartDate>String</StartDate>
</ListCallAllowanceBalanceRequest>
HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: length

<ArrayOfCallAllowanceBalanceInfo xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Evo.HostedSuite.Core.ServiceModel">
  <CallAllowanceBalanceInfo>
    <AllowanceDescription>String</AllowanceDescription>
    <Balance>0</Balance>
    <BalanceDescription>String</BalanceDescription>
    <ClientId>String</ClientId>
    <ClientName>String</ClientName>
    <NumCalls>0</NumCalls>
    <NumMins>0</NumMins>
    <ThirdPartyAccountId>String</ThirdPartyAccountId>
  </CallAllowanceBalanceInfo>
</ArrayOfCallAllowanceBalanceInfo>