POST | /api/call-allowance/balance |
---|
Name | Parameter | Data Type | Required | Description |
---|---|---|---|---|
StartDate | body | string | No | The start of the date range to list forms for |
EndDate | body | string | No | The end of the date range to list forms for |
ClientId | body | string | No | The ID of the client whose balance you want to get |
BillHold | body | bool | No | Whether you want to bill for hold time or not |
BillTalk | body | bool | No | Whether you want to bill for talk time or not |
BillTransfer | body | bool | No | Whether you want to bill for transfer time or not |
BillRing | body | bool | No | Whether you want to bill for ring time or not |
CallRounding | body | CallRoundingType | No | Round call durations (Possible values: None, NextMinute, Next30Seconds) |
MinCallDuration | body | double | No | The minimum duration of the call in seconds (talk time only) |
MaxCallDuration | body | double | No | The maximum duration of the call in seconds (talk time only) |
Name | Parameter | Data Type | Required | Description |
---|---|---|---|---|
CustomerName | form | string | Yes | The HostedSuite Customer Name |
UserName | form | string | Yes | The HostedSuite User Name. Data visibility and security is based on this user's permissions. |
Password | form | string | Yes | The HostedSuite User's Password |
None |
NextMinute |
Next30Seconds |
To override the Content-type in your clients, use the HTTP Accept Header, append the .xml suffix or ?format=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: cpo.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>