Returns distinct values for the specified criteria column. Use the returned values in the criteriaList[].criteriaValue array when calling Create Dynamic CG or Update Dynamic CG. Fetch valid columnId values from Get Dynamic CG Criteria Pattern. Supports pagination via rangeIndex/limit and text filtering via searchChar. For software version columns, filter by software name using softwareNameForVersion.
get /api/1.4/customgroup/dynamic/columnValues
https://{serverurl}/api/1.4/customgroup/dynamic/columnValues Copied!
Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52
Must be application/json. Only JSON responses are supported.
ID of the criteria column whose values to retrieve. Fetch from Get Dynamic CG Criteria Pattern. Column IDs are instance-specific auto-generated values.
Software name to filter version values. Used when columnId refers to a software version column.
Text filter applied to column values. Only values containing this string are returned.
Pagination start index (1-based). Default: 1
Maximum number of values to return per page. Default: 30
curl --request GET \
--url 'https://appdomains/api/1.4/customgroup/dynamic/columnValues?columnId=SOME_INTEGER_VALUE' \
--header 'Accept: application/json' \
--header 'Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52'Always 'dynamic' for this endpoint.
Response payload container.
Response payload.
Sequential-integer-keyed map ('0', '1', '2', …). Empty object {} when no values match.
Display text for the criteria value dropdown.
Actual value to use in criteriaValue array when calling Create Dynamic CG or Update Dynamic CG.
Display text for the criteria value dropdown.
Actual value to use in criteriaValue array when calling Create Dynamic CG or Update Dynamic CG.
Sequential-integer-keyed map ('0', '1', '2', …). Empty object {} when no values match.
Display text for the criteria value dropdown.
Actual value to use in criteriaValue array when calling Create Dynamic CG or Update Dynamic CG.
Display text for the criteria value dropdown.
Actual value to use in criteriaValue array when calling Create Dynamic CG or Update Dynamic CG.
Response payload.
Sequential-integer-keyed map ('0', '1', '2', …). Empty object {} when no values match.
Display text for the criteria value dropdown.
Actual value to use in criteriaValue array when calling Create Dynamic CG or Update Dynamic CG.
Display text for the criteria value dropdown.
Actual value to use in criteriaValue array when calling Create Dynamic CG or Update Dynamic CG.
Sequential-integer-keyed map ('0', '1', '2', …). Empty object {} when no values match.
Display text for the criteria value dropdown.
Actual value to use in criteriaValue array when calling Create Dynamic CG or Update Dynamic CG.
Display text for the criteria value dropdown.
Actual value to use in criteriaValue array when calling Create Dynamic CG or Update Dynamic CG.
API version: '1.4'.
'success' when the request completed without errors.
Always 'dynamic' for this endpoint.
API version: '1.4'.
Always 'error' for error responses.
Internal error code: '1003' (INTERNAL_ERROR).
Resolved I18N message, typically: An internal error occurred while processing the request.
OS name values for columnId for OS_NAME (instance-specific).
{
"message_type": "dynamic",
"message_response": {
"dynamic": {
"0": {
"label": "Windows 11 Enterprise",
"value": "Windows 11 Enterprise"
},
"1": {
"label": "Windows 10 Pro",
"value": "Windows 10 Pro"
},
"2": {
"label": "Windows Server 2022 Standard",
"value": "Windows Server 2022 Standard"
},
"3": {
"label": "Ubuntu 22.04 LTS",
"value": "Ubuntu 22.04 LTS"
}
}
},
"message_version": "1.4",
"status": "success"
}
Software version values filtered by softwareNameForVersion=Google Chrome.
{
"message_type": "dynamic",
"message_response": {
"dynamic": {
"0": {
"label": "120.0.6099.130",
"value": "120.0.6099.130"
},
"1": {
"label": "119.0.6045.200",
"value": "119.0.6045.200"
}
}
},
"message_version": "1.4",
"status": "success"
}
No matching values found for the column and filters.
{
"message_type": "dynamic",
"message_response": {
"dynamic": {}
},
"message_version": "1.4",
"status": "success"
}
Unexpected server-side failure retrieving column values.
{
"error_description": "An internal error occurred while processing the request.",
"message_type": "dynamic",
"error_code": "1003",
"message_version": "1.4",
"status": "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.