This endpoint provides detailed device-level usage data for specific contracts and invoices within a given timeframe.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Current month data con only be pulled form the 10th of the month onward.
This endpoint is for use by Direct customers only
Devices not rooted to an End-Customer will show under an empty client and will not be rolled up into a client-level total as there is no valid client allocated.
This endpoint supports Cove Data Protection, N‑central, and EDR.
Support for additional products will be added in future releases.
The detailed usage data is structured as a nested format, providing comprehensive records for all end customers (clients).
Each client record includes:
A list of devices with detailed information. Aggregated total usage by service for each customer, including metrics such as the amount of usage, price, and associated product features.
Sample response
{
"AccountName": "Best MSP",
"BpAccountId": 12348,
"Cid": "234578",
"ContractId": 234578,
"ContractNumber": "MSP-234567-01",
"ContractStatus": "ACTIVE",
"Created": "2021-01-04 20:02:13.470",
"PgaCode": "0100",
"Pid": "0118M-0000-0000-UK",
"ProductName": "Cove Data Protection | Data Protection Plan | MSP",
"RateClassId": "234567",
"SfdcAccountId": "001H234578asdfIAS",
"TenantId": "0100_678905",
"TimeFrame": 202508,
"Updated": "2023-12-31 22:09:37.204",
"TotalByContracts": [
{
"AccountName": "Best MSP",
"BpAccountId": "345678",
"Cid": "234578",
"ContractId": "234567",
"ContractNumber": "MSP-234578-01",
"InvoiceId": "123467",
"SfdcAccountId": "001H234578asdfIAS",
"AdditionalCapacity": [
{
"AdditionalCapacity": "-1830.479000000003",
"SelectedGbUsageQuantity": "2699.520999999997",
"Servers": {
"CommittedCount": 4,
"DeviceCount": 5,
"FUP": 2000,
"Pool": 10000,
"UsageCount": 5
},
"TimeFrame": 202508,
"TotalPool": 45500,
"UsedGB": "2699.520999999997",
"UsedGbUsageQuantity": "4452.173999999999",
"VirtualServers": {
"CommittedCount": 20,
"DeviceCount": 20,
"UsageCount": 15
},
"Workstations": {
"CommittedCount": 2,
"DeviceCount": 3,
"FUP": 500,
"Pool": 1500,
"UsageCount": 3
},
"Amount": "0",
"Price": "0.02",
"ProductFeatureName": "0100_ADDITIONAL_CAPACITY",
"Quantity": "0",
"Sku": "MSPUK-BU-AC"
}
]
}
],
"Clients": [
{
"ClientId": "1223442",
"Devices": [
{
"Detail": "username",
"DetailId": "deviceid",
"UsageLevel_5": "companyname",
"UsageLevel_3": "distiriutorname",
"UsageCompanyName": "customercompany",
"TotalByService": [
{
"Amount": 0.000,
"BillingServiceName": "Cove Data Protection | Per GB - Selected",
"Price": 0.000,
"ProductFeatureName": "0100_SELECTED_SIZE",
"Quantity": 195.860,
"Sku": "MSPUK-BU-PGS",
"Uom": "GB"
}
]
}
],
"Name": "customercompany",
"TotalByService": [
{
"Amount": 0.000,
"BillingServiceName": "Cove Data Protection | Per GB - Selected",
"Price": 0.000,
"ProductFeatureName": "0100_SELECTED_SIZE",
"Quantity": 195.860,
"Sku": "MSPUK-BU-PGS",
"Uom": "GB"
}
]
}
]
}