Deskhero Developer Hub
Back to deskhero.com
List entries

List_ only aggregates

Returns the distinct values, with hit counts, that the given field_keys take across the list, for populating filter inputs; take, page and the sort arguments in the filter are ignored because no entries come back alongside them. The 1000 row cap applies per field key rather than to the call as a whole, and when a filter is applied the value list is still the unfiltered one, with the filtered count reported next to the overall count.

GET /api/{tenant:minlength(2)}/v{version:apiVersion}/list_entries/{list_id}/aggregate
Authorisation
Minimum role: USER

Request arguments

Name Type Source
list_idInt32
field_keysString[]Query
filterDTO_standard_filterQuery
Request body example

Response

Status
200 (OK)
Type
Object[]
Wrapper
DTO_response_wrap_get_many
Other statuses
400 (BadRequest), 403 (Forbidden)
Response body example
DTO_standard_filter
NameTypeReadOnlyDescription
sort_by_keyStringSort by key
response_field_keysString[]Only return the fields specified
filtersString[]Each string needs to be structured: filters=field_key:operator:value1|value2|value3 Only used to store filters for passing along as querystring
include_aggregationsBooleanInclude aggregations
include_importedBooleanInclude imported
searchStringSearch
sort_orderENUM sort_orderSort order
takeInt32Take
pageInt32Page
ENUM sort_order
ValueNameDescription
0ASCASC
1DESCDESC

Generated Aug 4, 2026 18:37