Deskhero Developer Hub
Back to deskhero.com
List entries

List

Returns the entries of the given list, 100 per page ordered by creation date ascending unless sort_by_key and sort_order say otherwise, with take capped at 10000 and take multiplied by page not allowed to exceed 10000. Aggregations are built automatically from whichever fields the filter touched, and pagination.item_count_total is the list's overall entry count rather than the filtered one.

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

Request arguments

Name Type Source
list_idInt32
filterDTO_standard_filterQuery
Request body example

Response

Status
200 (OK)
Type
DTO_list_entry[]
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
DTO_list_entry
NameTypeReadOnlyDescription
idInt32ReadOnlyId
createdDateTimeReadOnlyCreated
created_byDTO_reference_userReadOnlyCreated by
last_updatedDateTimeReadOnlyLast updated
last_updated_byDTO_reference_userReadOnlyLast updated by
DTO_reference_user
NameTypeReadOnlyDescription
profile_picStringReadOnlyProfile pic
emailStringReadOnlyEmail
idInt32Id
labelObjectReadOnlyLabel
ENUM sort_order
ValueNameDescription
0ASCASC
1DESCDESC

Generated Aug 4, 2026 18:37