Retrieves the SoM computer summary based on agent installation status and the last agent contact time.
https://{serverurl}/api/1.4/som/summary
Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52
Specifies the page number to retrieve. Default is 1
Specifies the maximum number of items to return per page. The default value is 25. A maximum of 1000 records can be retrieved in a single request
curl --request GET \
--url https://appdomains/api/1.4/som/summary \
--header 'Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52'Name of the module
Response message containing summary details
Computer summary based on the computer's most recent contact with the server
No of agents contacted server in last 3 days
No of agents contacted server between 4 and 7 days ago
No of agents contacted server between 8 and 15 days ago
No of agents contacted server between 16 and 30 days ago
Agent has not contacted the server in the last 30 days
Computer summary based on the agent installation state of each device
No of computers where agent uninstallation failed
No of computers where agent was installed successfully
No of Computers in Endpoint central
No of computers where agent intallation failed
No of computers where the agent yet to be installed
No of computers where the agent was unistalled successfully
Computer summary categorized by the live status of each device
No of computers in down state
No of computers in live state
No of computers with unknown state
Version of the Api
Status of the request
Request processed successfully
{
"message_type": "summary",
"message_response": {
"summary": {
"last_contact_time_summary": {
"equal_3_day": 2,
"8_day_to_15_day": 0,
"16_day_to_30_day": 0,
"greater_30_day": 0,
"4_day_to_7_day": 1
},
"installation_status_summary": {
"uninstallation_failed": 1,
"installed": 1,
"total": 3,
"installation_failed": 0,
"yet_to_install": 1,
"uninstalled": 0
},
"live_status_summary": {
"down": 0,
"live": 3,
"unknown": 0
}
}
},
"message_version": "1.4",
"status": "success"
}
![]()
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.