Returns every Windows service that can be referenced in a Services template, covering both the predefined services shipped with the product and services added for this customer. Use the serviceName and displayName from this response when building the Services template payload.
get /dcapi/configuration/windows/services
https://{serverurl}/dcapi/configuration/windows/services Copied!
Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52
Versioned media type of the response body, as produced by the endpoint.
curl --request GET \
--url https://appdomains/dcapi/configuration/windows/services \
--header 'Accept: application/windowsServices.v1+json' \
--header 'Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52'One Windows service that can be referenced in a Services configuration policy.
Unique identifier of the service entry in the repository.
Internal Windows service name. Pass this value as serviceName in the Services configuration payload.
Human-readable name of the service. Localised for predefined services. Pass this value as displayName in the Services configuration payload.
What the service does. Localised for predefined services.
Origin of the entry. Allowed values:
1 = defined for this customer
2 = predefined and shipped with the product
Entries with inputType 1 are returned only for the customer that owns them.
Unauthorized error code returned when authentication credentials are missing, expired, or invalid (authentication=required)
Authentication failure reason
Error response when the Windows services list cannot be read.
Product error code. 50001 = CONFIG_INTERNAL_ERROR: the services repository could not be queried.
Localised error message for the error code.
A predefined service followed by a customer-defined one
[
{
"displayName": "Windows Update",
"description": "Enables the detection, download, and installation of updates.",
"inputType": 2,
"serviceID": 1,
"serviceName": "wuauserv"
},
{
"displayName": "My Custom Service",
"description": "Custom service added for this customer.",
"inputType": 1,
"serviceID": 25,
"serviceName": "MyCustomService"
}
]
User is not authorized to list Windows services
{
"errorCode": 1001,
"errorMsg": "Access denied - You are not allowed to access the requested resource."
}
Server error while reading the services list
{
"errorCode": 50001,
"errorMsg": "An Internal Error occurred, try again later."
}
![]()
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.