post
https://prod-nableboomi.n-able.com:443/ws/rest/V1/PSA_API/PSAUsageDetailsDevices////
This endpoint provides detailed device-level usage data for specific contracts and invoices within a given timeframe.
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
Current month data con only be pulled form the 10th of the month onward.
This endpoint is for use by Direct customers only
Only devices rooted at the end customer level (Level 7) show in this API. It is recommended that all devices be rooted at this level within the product.
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"
}
]
}
]
}