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

HTTP + JSV

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: text/jsv
Content-Type: text/jsv
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: text/jsv
Content-Length: length

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