Fetches the installation execution status for each target resource in a deployment collection, including success/failure remarks and timestamps.
get /dcapi/swDeployment/swExecutionStatus
https://{serverurl}/dcapi/swDeployment/swExecutionStatus
Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52
Deployment collection ID. Obtain from the collectionId field in the response of the Custom Group Deployments API.
Target resource ID to filter execution status for a specific computer. Obtain from the resourceId field in the response of the Get Computers API.
Optional status filter: Yet to Install, Installed, Failed, Uninstalled, or Downloading.
Optional package name filter to narrow results to a specific package.
Zero-based starting index. Defaults to 0.
Maximum records per page. Maximum allowed value: 1000.
curl --request GET \
--url https://appdomains/dcapi/swDeployment/swExecutionStatus \
--header 'Accept: application/swExecutionStatus.v1+json' \
--header 'Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52'Total number of execution status records
Array of per-resource execution status entries
Managed resource (computer) identifier
Display name of the managed resource
Name of the deployed software package
Execution status: Yet to Install, Installed, Failed, Uninstalled, Downloading
Detailed status remarks or error description
Epoch timestamp (ms) of last execution attempt
INTERNAL_ERROR for DB query failures, SW_INTERNAL_ERROR for package operation errors
Internal server error with details about the package retrieval or execution status failure
Mixed execution results
{
"executionDetails": [
{
"resourceId": 301,
"executedTime": 1713264000000,
"resourceName": "DESKTOP-ABC123",
"packageName": "7-Zip",
"remarks": "Successfully installed",
"status": "Installed"
}
],
"totalCount": 2
}
Server error
{
"errorMessage": "Internal Server Error",
"errorCode": "INTERNAL_ERROR"
}
![]()
Duration: 1 minute | Threshold: 30 | 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.