Deskhero Developer Hub
Back to deskhero.com
Tickets

List_ only aggregates

Returns the distinct values, with hit counts, that the given field_keys take across the tickets matching the filter, for populating filter inputs. At most 1000 distinct values come back per field key, no tickets are returned alongside them, and a field key that matches nothing fails the whole call.

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

Request arguments

Name Type Source
field_keysString[]Query
filterDTO_ticket_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_ticket_filter
NameTypeReadOnlyDescription
include_hiddenBooleanInclude hidden
include_soft_deletedBooleanInclude soft deleted
statusStringStatus
sort_by_keyStringSort by key
response_field_keysString[]Response field keys
filtersString[]Filters
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