Returns all computers linked to a specified software metering rule by app definition ID.
get /dcapi/inventory/viewData/computersBySM
https://{serverurl}/dcapi/inventory/viewData/computersBySM
DesktopCentralCloud.Inventory.READCopied!
Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52
Set value as 7774
App definition ID for the software metering rule. Obtain from the response of the Get Software Metering Rules List API.
Domain name to filter computers. Obtain from the response of the Get Computers List API.
Branch office ID to filter computers. Obtain it from the response of the Get Remote Office List API.
curl --request GET \
--url 'https://appdomain/dcapi/inventory/viewData/computersBySM?toolID=7774&appDefID=SOME_STRING_VALUE' \
--header 'Accept: application/InventoryMobileAPI.v1+json' \
--header 'Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52'Pagination metadata
Number of items returned per page
Current page number in paginated response
Total number of records matching the query
Array of computer metering detail objects
File version
Computer name display value
Last updated time as epoch timestamp
Product name display value
Branch office name
Last used time as epoch timestamp
Domain NetBIOS name
Branch office identifier
Updated time display value
Fully qualified domain name
Last used time display value
Total run time display value
Resource ID for live status lookup
Total run count display value
File version display value
Domain NetBIOS name display value
Product version
Computer friendly name
Total run time in seconds
Resource resource identifier
FQDN display value
Product version display value
Product name
Total run count
App definition identifier
Resource identifier
Computer live status code
Computer resource name
Customer identifier
Friendly name display value
Status update time as epoch timestamp
Total number of pages
Pagination links
URL to the next page of results, null if last page
URL to the previous page of results, null if first page
Response status - success
INTERNAL_ERROR - unexpected exception in the service layer
Internal server error message
Computers by metering rule
{
"metadata": {
"limit": 25,
"page": 1
},
"totalRecords": "1",
"messageResponse": [
{
"file_version": "",
"resource_name_transform": "sample-computer",
"updated_time": "1778827912158",
"product_name_transform": "Sample App",
"branch_office_name": "Local Office",
"last_used": "1778810902000",
"domain_netbios_name": "WORKGROUP",
"branch_office_id": "1",
"updated_time_transform": "May 15, 2026 12:21 PM",
"fqdn_name": "sample-computer.example.com",
"last_used_transform": "May 15, 2026 07:38 AM",
"total_run_time_transform": "03 days, 05 hours, 13 minutes",
"live_status_resource_id": "301",
"total_run_count_transform": "598",
"file_version_transform": "--",
"domain_netbios_name_transform": "WORKGROUP",
"product_version": "",
"friendly_name": "sample-computer",
"total_run_time": "278024",
"resource_resource_id": "301",
"fqdn_name_transform": "sample-computer.example.com",
"product_version_transform": "--",
"product_name": "Sample App",
"total_run_count": "598",
"app_definition_id": "2",
"resource_id": "301",
"computer_live_status": "1",
"resource_name": "sample-computer",
"customer_id": "1",
"friendly_name_transform": "sample-computer",
"computer_status_update_time": "1778767913704"
}
],
"totalPages": 1,
"Links": {
"next": null,
"prev": null
},
"status": "success"
}
Server error
{
"error_description": "Internal server error",
"error_code": "INTERNAL_ERROR"
}
![]()
Duration: 1 minute | Threshold: 120 | Lock period: 5 minutes
Duration - Time window for the threshold.
Threshold - Number of API calls allowed within the specified duration.
Lock Period - Wait time before consecutive API requests.
© 2026, Zoho Corporation Pvt. Ltd. All Rights Reserved.