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 .json suffix or ?format=json

To embed the response in a jsonp callback, append ?callback=myCallback

HTTP + JSON

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/json
Content-Type: application/json
Content-Length: length

{"StartDate":"String","EndDate":"String","ClientId":"String","BillHold":false,"BillTalk":false,"BillTransfer":false,"BillRing":false,"CallRounding":"None","MinCallDuration":0,"MaxCallDuration":0,"CustomerName":"String","UserName":"String","Password":"String"}
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: length

[{"ClientId":"String","ThirdPartyAccountId":"String","ClientName":"String","AllowanceDescription":"String","NumCalls":0,"NumMins":0,"Balance":0,"BalanceDescription":"String"}]