Returns the current targets of a collection, configuration as an array of numeric resource IDs.The response format matches the input expected by the modifyTargets endpoint — making it easy to fetch, modify, and resubmit targets without format conversion.To use this format, pass useResourceIdFormat=true as a query parameter.
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.
Target descriptor in Resource ID format containing the target type and an array of numeric resource IDs.
Target category — 'computer' for computer-based collections, 'user' for user-based collections.
Array of numeric resource IDs currently targeted by the collection. Only actively managed resources (MANAGED_BY_DC) are included for computer-type collections.
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 three targeted resources (Resource ID format)
{
"collectionId": 12345,
"targetDetails": {
"values": [
1001,
1002,
1003
],
"type": "computer"
}
}
User-type collection with two targeted user resources (Resource ID format)
{
"collectionId": 67890,
"targetDetails": {
"values": [
2001,
2002
],
"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.