POST /service/api/securecloud/usage/charges
?limit={limit}
&offset={offset}
&cursor={cursor}
Gets a list of subscription charges. A subscription charge provides a snapshot of a customer's current charges.
Note: Responses of charges API are dependent on filters, ordering set in the request.
The response from the charges API varies based on the filters, sorting parameters and fields specified in the request body.
For more information, refer to the sections on Filter Operations and Expressions used for filtering results.
When using a cursor, body content is not allowed. In such a case, please construct the URI parameters as follows: 'page[limit]={yourlimit}&page[offset]={youroffset}&filter[chargeCode]={yourchargecode}&filter[isTrial]={true or false}&sort={sort field, e.g. ChargeCode}&sort={secondary sort field, e.g. -Currency}'. Following this, the resulting parameter string needs to be encoded (Base64) and then passed to the cursor as a URI parameter.
Request Information
URI Parameters
| Name | Description | Type | Additional Information |
|---|---|---|---|
| limit |
The maximum number of records to return. |
integer |
None. |
| offset |
The number of records to be skipped (the first record to be displayed). |
integer |
None. |
| cursor |
Encoded value of the url. e.g. ZmlsdGVyW2lzQXV0b1JlbmV3XT1lcTondHJ1ZScmc29ydD1DaGFyZ2VDb2RlLC1DdXJyZW5jeSZwYWdlW2xpbWl0XT0xMCZwYWdlW29mZnNldF09MTA |
string |
None. |
URI Sample(s)
|
POST
|
https://unityapi.webrootcloudav.com/service/api/securecloud/usage/charges?limit=15&offset=0
|
|
POST
|
https://unityapi.webrootcloudav.com/service/api/securecloud/usage/charges?limit=10
|
|
POST
|
https://unityapi.webrootcloudav.com/service/api/securecloud/usage/charges?cursor=c29ydD1DaGFyZ2VDb2RlLC1DdXJyZW5jeSZwYWdlW2xpbWl0XT0xJnBhZ2Vbb2Zmc2V0XT0x
|
Body Parameters
Additional information containing filters, sort order and a definition of fields that will be included in the response.
SubscriptionChargesRequestModel| Name | Description | Type | Additional Information |
|---|---|---|---|
| SubscriptionChargesFilterFields |
Filters the charges events (optional, multiple parameters can be added) e.g. "IsTrial": "eq:false". |
SubscriptionChargesFilterFields |
Optional. |
| Sorting |
Controls sort order of the events in the response (optional, multiple parameters can be added) e.g. {"IsTrial" : "Ascending"}. |
ChargesSorting |
Optional. |
| Fields |
Defines the fields to be included in the response. (optional, multiple parameters can be added).The parameter is case-insensitive(e.g. ["IsTrial", "chargeCode"]). If it is omitted, the response will include all possible fields by default. |
ChargesFields |
Optional. |
Sample Request
{
"SubscriptionChargesFilterFields": {
"Id": "38416-BACKUP-1-1-BASICUSRS-59",
"ChargeCode": "in:BASICUSRS-59,CRSUSRS-3",
"ChargeName": "Cloud Charge 1",
"ChargeType": "Recurring",
"ProductName": "Cloud Product1",
"ProductType": "CloudBackup",
"BillableItem": "BasicUsers",
"Price": "10",
"TermPrice": "10",
"Currency": "USD",
"Quantity": "0",
"Total": "0",
"Description": "Cloud Charge 1",
"SubscriptionStartDate": "2024-12-21T07:46:33.638Z",
"SubscriptionCanceled": "false",
"SubscriptionCanceledDate": "2024-12-21T07:46:33.638Z",
"InitialTerm": "1",
"CurrentTerm": "1",
"CommitmentTerm": "0",
"TermStartDate": "2024-12-21T07:46:33.638Z",
"TermEndDate": "2025-03-21T07:46:33.638Z",
"IsTrial": "eq:true",
"IsAutoRenew": "eq:false",
"EffectiveDate": "2025-01-05T07:46:33.638Z",
"EndDate": null,
"CustomerName": "[TEST] KPR AppRiver Resold",
"CustomerType": "Resold",
"ProductId": "8d9ebdee-cfc5-4515-b139-ad170101bd25",
"PartnerId": "7b24e2ee-7018-40bd-8aab-a8eb00d7ed8b",
"SubscriptionId": "38416-BACKUP-1-1",
"CustomerId": "d53f91e8-ecb8-4d3b-aec8-ac3601501e0c",
"BillToAccountId": "1195c23d-0fe0-435a-ad45-a8eb00d7ed0c"
},
"Sorting": {
"Parameters": {
"ChargeCode": "Ascending",
"ChargeName": "Descending",
"ChargeType": "Ascending",
"ProductName": "Descending",
"ProductType": "Ascending",
"BillableItem": "Descending",
"Price": "Ascending",
"TermPrice": "Descending",
"Currency": "Ascending",
"Quantity": "Descending",
"Total": "Ascending",
"Description": "Descending",
"SubscriptionStartDate": "Ascending",
"SubscriptionCanceled": "Descending",
"SubscriptionCanceledDate": "Ascending",
"InitialTerm": "Descending",
"CurrentTerm": "Ascending",
"CommitmentTerm": "Descending",
"TermStartDate": "Ascending",
"TermEndDate": "Descending",
"IsTrial": "Ascending",
"IsAutoRenew": "Descending",
"EffectiveDate": "Ascending",
"EndDate": "Descending",
"CustomerName": "Ascending",
"CustomerType": "Descending"
}
},
"Fields": {
"FieldParam": [
"ChargeCode",
"CustomerName",
"CustomerType",
"ChargeName",
"IsTrial",
"IsAutoRenew",
"EffectiveDate",
"EndDate",
"ChargeType",
"ProductName",
"ProductType",
"BillableItem",
"Price",
"TermPrice",
"Currency",
"Quantity",
"Total",
"Description",
"SubscriptionStartDate",
"SubscriptionCanceled",
"SubscriptionCanceledDate",
"InitialTerm",
"CurrentTerm",
"CommitmentTerm",
"TermStartDate",
"TermEndDate"
]
}
}
<SubscriptionChargesRequestModel xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Webroot.UnityAPI.ServiceExtension.SecureCloud.Models">
<Fields>
<FieldParam xmlns:d3p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
<d3p1:string>ChargeCode</d3p1:string>
<d3p1:string>CustomerName</d3p1:string>
<d3p1:string>CustomerType</d3p1:string>
<d3p1:string>ChargeName</d3p1:string>
<d3p1:string>IsTrial</d3p1:string>
<d3p1:string>IsAutoRenew</d3p1:string>
<d3p1:string>EffectiveDate</d3p1:string>
<d3p1:string>EndDate</d3p1:string>
<d3p1:string>ChargeType</d3p1:string>
<d3p1:string>ProductName</d3p1:string>
<d3p1:string>ProductType</d3p1:string>
<d3p1:string>BillableItem</d3p1:string>
<d3p1:string>Price</d3p1:string>
<d3p1:string>TermPrice</d3p1:string>
<d3p1:string>Currency</d3p1:string>
<d3p1:string>Quantity</d3p1:string>
<d3p1:string>Total</d3p1:string>
<d3p1:string>Description</d3p1:string>
<d3p1:string>SubscriptionStartDate</d3p1:string>
<d3p1:string>SubscriptionCanceled</d3p1:string>
<d3p1:string>SubscriptionCanceledDate</d3p1:string>
<d3p1:string>InitialTerm</d3p1:string>
<d3p1:string>CurrentTerm</d3p1:string>
<d3p1:string>CommitmentTerm</d3p1:string>
<d3p1:string>TermStartDate</d3p1:string>
<d3p1:string>TermEndDate</d3p1:string>
</FieldParam>
</Fields>
<Sorting>
<Parameters xmlns:d3p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
<d3p1:KeyValueOfstringstring>
<d3p1:Key>ChargeCode</d3p1:Key>
<d3p1:Value>Ascending</d3p1:Value>
</d3p1:KeyValueOfstringstring>
<d3p1:KeyValueOfstringstring>
<d3p1:Key>ChargeName</d3p1:Key>
<d3p1:Value>Descending</d3p1:Value>
</d3p1:KeyValueOfstringstring>
<d3p1:KeyValueOfstringstring>
<d3p1:Key>ChargeType</d3p1:Key>
<d3p1:Value>Ascending</d3p1:Value>
</d3p1:KeyValueOfstringstring>
<d3p1:KeyValueOfstringstring>
<d3p1:Key>ProductName</d3p1:Key>
<d3p1:Value>Descending</d3p1:Value>
</d3p1:KeyValueOfstringstring>
<d3p1:KeyValueOfstringstring>
<d3p1:Key>ProductType</d3p1:Key>
<d3p1:Value>Ascending</d3p1:Value>
</d3p1:KeyValueOfstringstring>
<d3p1:KeyValueOfstringstring>
<d3p1:Key>BillableItem</d3p1:Key>
<d3p1:Value>Descending</d3p1:Value>
</d3p1:KeyValueOfstringstring>
<d3p1:KeyValueOfstringstring>
<d3p1:Key>Price</d3p1:Key>
<d3p1:Value>Ascending</d3p1:Value>
</d3p1:KeyValueOfstringstring>
<d3p1:KeyValueOfstringstring>
<d3p1:Key>TermPrice</d3p1:Key>
<d3p1:Value>Descending</d3p1:Value>
</d3p1:KeyValueOfstringstring>
<d3p1:KeyValueOfstringstring>
<d3p1:Key>Currency</d3p1:Key>
<d3p1:Value>Ascending</d3p1:Value>
</d3p1:KeyValueOfstringstring>
<d3p1:KeyValueOfstringstring>
<d3p1:Key>Quantity</d3p1:Key>
<d3p1:Value>Descending</d3p1:Value>
</d3p1:KeyValueOfstringstring>
<d3p1:KeyValueOfstringstring>
<d3p1:Key>Total</d3p1:Key>
<d3p1:Value>Ascending</d3p1:Value>
</d3p1:KeyValueOfstringstring>
<d3p1:KeyValueOfstringstring>
<d3p1:Key>Description</d3p1:Key>
<d3p1:Value>Descending</d3p1:Value>
</d3p1:KeyValueOfstringstring>
<d3p1:KeyValueOfstringstring>
<d3p1:Key>SubscriptionStartDate</d3p1:Key>
<d3p1:Value>Ascending</d3p1:Value>
</d3p1:KeyValueOfstringstring>
<d3p1:KeyValueOfstringstring>
<d3p1:Key>SubscriptionCanceled</d3p1:Key>
<d3p1:Value>Descending</d3p1:Value>
</d3p1:KeyValueOfstringstring>
<d3p1:KeyValueOfstringstring>
<d3p1:Key>SubscriptionCanceledDate</d3p1:Key>
<d3p1:Value>Ascending</d3p1:Value>
</d3p1:KeyValueOfstringstring>
<d3p1:KeyValueOfstringstring>
<d3p1:Key>InitialTerm</d3p1:Key>
<d3p1:Value>Descending</d3p1:Value>
</d3p1:KeyValueOfstringstring>
<d3p1:KeyValueOfstringstring>
<d3p1:Key>CurrentTerm</d3p1:Key>
<d3p1:Value>Ascending</d3p1:Value>
</d3p1:KeyValueOfstringstring>
<d3p1:KeyValueOfstringstring>
<d3p1:Key>CommitmentTerm</d3p1:Key>
<d3p1:Value>Descending</d3p1:Value>
</d3p1:KeyValueOfstringstring>
<d3p1:KeyValueOfstringstring>
<d3p1:Key>TermStartDate</d3p1:Key>
<d3p1:Value>Ascending</d3p1:Value>
</d3p1:KeyValueOfstringstring>
<d3p1:KeyValueOfstringstring>
<d3p1:Key>TermEndDate</d3p1:Key>
<d3p1:Value>Descending</d3p1:Value>
</d3p1:KeyValueOfstringstring>
<d3p1:KeyValueOfstringstring>
<d3p1:Key>IsTrial</d3p1:Key>
<d3p1:Value>Ascending</d3p1:Value>
</d3p1:KeyValueOfstringstring>
<d3p1:KeyValueOfstringstring>
<d3p1:Key>IsAutoRenew</d3p1:Key>
<d3p1:Value>Descending</d3p1:Value>
</d3p1:KeyValueOfstringstring>
<d3p1:KeyValueOfstringstring>
<d3p1:Key>EffectiveDate</d3p1:Key>
<d3p1:Value>Ascending</d3p1:Value>
</d3p1:KeyValueOfstringstring>
<d3p1:KeyValueOfstringstring>
<d3p1:Key>EndDate</d3p1:Key>
<d3p1:Value>Descending</d3p1:Value>
</d3p1:KeyValueOfstringstring>
<d3p1:KeyValueOfstringstring>
<d3p1:Key>CustomerName</d3p1:Key>
<d3p1:Value>Ascending</d3p1:Value>
</d3p1:KeyValueOfstringstring>
<d3p1:KeyValueOfstringstring>
<d3p1:Key>CustomerType</d3p1:Key>
<d3p1:Value>Descending</d3p1:Value>
</d3p1:KeyValueOfstringstring>
</Parameters>
</Sorting>
<SubscriptionChargesFilterFields>
<BillToAccountId>1195c23d-0fe0-435a-ad45-a8eb00d7ed0c</BillToAccountId>
<BillableItem>BasicUsers</BillableItem>
<ChargeCode>in:BASICUSRS-59,CRSUSRS-3</ChargeCode>
<ChargeName>Cloud Charge 1</ChargeName>
<ChargeType>Recurring</ChargeType>
<CommitmentTerm>0</CommitmentTerm>
<Currency>USD</Currency>
<CurrentTerm>1</CurrentTerm>
<CustomerId>d53f91e8-ecb8-4d3b-aec8-ac3601501e0c</CustomerId>
<CustomerName>[TEST] KPR AppRiver Resold</CustomerName>
<CustomerType>Resold</CustomerType>
<Description>Cloud Charge 1</Description>
<EffectiveDate>2025-01-05T07:46:33.638Z</EffectiveDate>
<EndDate i:nil="true" />
<Id>38416-BACKUP-1-1-BASICUSRS-59</Id>
<InitialTerm>1</InitialTerm>
<IsAutoRenew>eq:false</IsAutoRenew>
<IsTrial>eq:true</IsTrial>
<PartnerId>7b24e2ee-7018-40bd-8aab-a8eb00d7ed8b</PartnerId>
<Price>10</Price>
<ProductId>8d9ebdee-cfc5-4515-b139-ad170101bd25</ProductId>
<ProductName>Cloud Product1</ProductName>
<ProductType>CloudBackup</ProductType>
<Quantity>0</Quantity>
<SubscriptionCanceled>false</SubscriptionCanceled>
<SubscriptionCanceledDate>2024-12-21T07:46:33.638Z</SubscriptionCanceledDate>
<SubscriptionId>38416-BACKUP-1-1</SubscriptionId>
<SubscriptionStartDate>2024-12-21T07:46:33.638Z</SubscriptionStartDate>
<TermEndDate>2025-03-21T07:46:33.638Z</TermEndDate>
<TermPrice>10</TermPrice>
<TermStartDate>2024-12-21T07:46:33.638Z</TermStartDate>
<Total>0</Total>
</SubscriptionChargesFilterFields>
</SubscriptionChargesRequestModel>
Response Information
Resource Description
Returns object of subscriptionChargesResponseModel which is the list of subscription charges. A subscription charge is a snapshot of a customer's current charges.
SubscriptionChargesResponseModel| Name | Description | Type | Additional Information |
|---|---|---|---|
| Data |
Defines information associated with the subscription charge. |
Collection of SubscriptionChargesResult |
None. |
| Links |
Page details. |
SubscriptionChargesLinks |
None. |
| Meta |
Total number of records associated with the subscription charge result. |
SubscriptionChargesPageMeta |
None. |
Sample Response
{
"Data": [
{
"Type": "subscriptionCharges",
"Id": "38416-BACKUP-1-1-BASICUSRS-59",
"Attributes": {
"ChargeCode": "in:BASICUSRS-59,CRSUSRS-3",
"ChargeName": "Cloud Charge 1",
"ChargeType": "Recurring",
"ProductName": "Cloud Product1",
"ProductType": "CloudBackup",
"BillableItem": "BasicUsers",
"Price": 10.0,
"TermPrice": 10.0,
"Currency": "USD",
"Quantity": 0,
"Total": 0.0,
"Description": "Cloud Charge 1",
"SubscriptionStartDate": "2024-12-21T07:46:33.6642798Z",
"SubscriptionCanceled": false,
"SubscriptionCanceledDate": "2024-12-21T07:46:33.6642798Z",
"InitialTerm": 1,
"CurrentTerm": 1,
"CommitmentTerm": 0,
"TermStartDate": "2024-12-21T07:46:33.6642798Z",
"TermEndDate": "2025-03-21T07:46:33.6642798Z",
"IsTrial": true,
"IsAutoRenew": false,
"EffectiveDate": "2025-01-05T07:46:33.6642798Z",
"EndDate": null,
"CustomerName": "[TEST] KPR AppRiver Resold",
"CustomerType": "Resold"
},
"Relationships": {
"Product": {
"Data": {
"Type": "products",
"Id": "8d9ebdee-cfc5-4515-b139-ad170101bd25",
"Meta": {}
}
},
"Partner": {
"Data": {
"Type": "partners",
"Id": "7b24e2ee-7018-40bd-8aab-a8eb00d7ed8b",
"Meta": {}
}
},
"Subscription": {
"Data": {
"Type": "subscriptions",
"Id": "38416-BACKUP-1-1",
"Meta": {}
}
},
"Customer": {
"Data": {
"Type": "",
"Id": "d53f91e8-ecb8-4d3b-aec8-ac3601501e0c",
"Meta": {}
}
},
"BillToAccount": {
"Data": {
"Type": "billingAccounts",
"Id": "1195c23d-0fe0-435a-ad45-a8eb00d7ed0c",
"Meta": {}
}
}
}
}
],
"Links": {
"NextPageLimit": 10,
"NextPageOffset": 10
},
"Meta": {
"Page": {
"Total": 10
}
}
}
<SubscriptionChargesResponseModel xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Webroot.UnityAPI.ServiceExtension.SecureCloud.Models">
<Data>
<SubscriptionChargesResult>
<Attributes>
<BillableItem>BasicUsers</BillableItem>
<ChargeCode>in:BASICUSRS-59,CRSUSRS-3</ChargeCode>
<ChargeName>Cloud Charge 1</ChargeName>
<ChargeType>Recurring</ChargeType>
<CommitmentTerm>0</CommitmentTerm>
<Currency>USD</Currency>
<CurrentTerm>1</CurrentTerm>
<CustomerName>[TEST] KPR AppRiver Resold</CustomerName>
<CustomerType>Resold</CustomerType>
<Description>Cloud Charge 1</Description>
<EffectiveDate>2025-01-05T07:46:33.6642798Z</EffectiveDate>
<EndDate i:nil="true" />
<InitialTerm>1</InitialTerm>
<IsAutoRenew>false</IsAutoRenew>
<IsTrial>true</IsTrial>
<Price>10</Price>
<ProductName>Cloud Product1</ProductName>
<ProductType>CloudBackup</ProductType>
<Quantity>0</Quantity>
<SubscriptionCanceled>false</SubscriptionCanceled>
<SubscriptionCanceledDate>2024-12-21T07:46:33.6642798Z</SubscriptionCanceledDate>
<SubscriptionStartDate>2024-12-21T07:46:33.6642798Z</SubscriptionStartDate>
<TermEndDate>2025-03-21T07:46:33.6642798Z</TermEndDate>
<TermPrice>10</TermPrice>
<TermStartDate>2024-12-21T07:46:33.6642798Z</TermStartDate>
<Total>0</Total>
</Attributes>
<Id>38416-BACKUP-1-1-BASICUSRS-59</Id>
<Relationships>
<BillToAccount>
<Data>
<Id>1195c23d-0fe0-435a-ad45-a8eb00d7ed0c</Id>
<Meta>
<BillToAccountNumber i:nil="true" />
<CustomerNumber i:nil="true" />
</Meta>
<Type>billingAccounts</Type>
</Data>
</BillToAccount>
<Customer>
<Data>
<Id>d53f91e8-ecb8-4d3b-aec8-ac3601501e0c</Id>
<Meta>
<BillToAccountNumber i:nil="true" />
<CustomerNumber i:nil="true" />
</Meta>
<Type></Type>
</Data>
</Customer>
<Partner>
<Data>
<Id>7b24e2ee-7018-40bd-8aab-a8eb00d7ed8b</Id>
<Meta>
<BillToAccountNumber i:nil="true" />
<CustomerNumber i:nil="true" />
</Meta>
<Type>partners</Type>
</Data>
</Partner>
<Product>
<Data>
<Id>8d9ebdee-cfc5-4515-b139-ad170101bd25</Id>
<Meta>
<BillToAccountNumber i:nil="true" />
<CustomerNumber i:nil="true" />
</Meta>
<Type>products</Type>
</Data>
</Product>
<Subscription>
<Data>
<Id>38416-BACKUP-1-1</Id>
<Meta>
<BillToAccountNumber i:nil="true" />
<CustomerNumber i:nil="true" />
</Meta>
<Type>subscriptions</Type>
</Data>
</Subscription>
</Relationships>
<Type>subscriptionCharges</Type>
</SubscriptionChargesResult>
</Data>
<Links>
<NextPageLimit>10</NextPageLimit>
<NextPageOffset>10</NextPageOffset>
</Links>
<Meta>
<Page>
<Total>10</Total>
</Page>
</Meta>
</SubscriptionChargesResponseModel>