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://{serverurl}/dcapi/target/{collectionId}/getTargets
Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52
The unique numeric identifier of the collection whose targets are to be retrieved. Fetch from Get Configurations View .
Omit or set to false to receive the domain/value pairs response format.
curl --request GET \
--url https://appdomains/dcapi/target/{collectionId}/getTargets \
--header 'Accept: application/getTargets.v1+json' \
--header 'Authorization: Zoho-oauthtoken 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: credentials missing, expired, or invalid
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.