Returns the current targets of a collection, configuration as an array of domain and value pairs.The response format matches the input expected by the modifyTargets endpoint — making it easy to fetch, modify, and resubmit targets without format conversion.This is the default format. No additional query parameters are needed. omit useResourceIdFormat or set it to false.
get /dcapi/target/{collectionId}/getTargets
https://{server-hostname}:8383/dcapi/target/{collectionId}/getTargets
Configurations.READCopied!
(or)
SWDeployment.READCopied!
(or)
PatchMgmt.READCopied!
(or)
VulnerabilityMgmt.READCopied!
Authorization: d92d4xxxxxxxxxxxxx15f52
The unique numeric identifier of the collection whose targets are to be retrieved. Fetch from Get Configurations View .
curl --request GET \
--url https://appdomain/dcapi/target/{collectionId}/getTargets \
--header 'Accept: application/getTargets.v1+json' \
--header 'Authorization: d92d4xxxxxxxxxxxxx15f52'Unique collection ID whose targets are returned.
Array containing a single filter entry. Each entry holds a filter object with the target type and an array of name/domain pairs identifying targeted resources.
Filter descriptor identifying the target type and the list of resource name/domain pairs.
Target category — 'Computer' for computer-based collections, 'User' for user-based collections.
Array of name/domain pair objects identifying each targeted resource.
NetBIOS computer name or username of the targeted resource.
Active Directory domain or workgroup the targeted resource belongs to.
CONFIG_INVALID_INPUT_DATA: the specified collection is expired or no longer alive.
Message indicating the collection is not active or has expired.
Unauthorized error code returned when authentication credentials are missing, expired, or invalid (authentication=required)
Authentication failure reason
Computer-type collection with two targeted computers (domain and value format)
{
"collectionId": 12345,
"targets": [
{
"filter": {
"values": [
{
"domain": "CORP",
"value": "PC-001"
},
{
"domain": "CORP",
"value": "LAPTOP-DEF"
}
],
"type": "Computer"
}
}
]
}
User-type collection with one targeted user (domain and value format)
{
"collectionId": 67890,
"targets": [
{
"filter": {
"values": [
{
"domain": "CORP",
"value": "jdoe"
}
],
"type": "User"
}
}
]
}
Collection is expired or no longer active
{
"error_description": "Collection is not active or expired",
"error_code": "CONFIG_INVALID_INPUT_DATA"
}
User lacks read role for this configuration type
{
"error_description": "Access denied - You are not allowed to access the requested resource.",
"error_code": "UAC_UNAUTHORIZED"
}
![]()
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.
© 2026, Zoho Corporation Pvt. Ltd. All Rights Reserved.