List support tickets
Pull the desk's queue into your own product, filtered, sorted and paged.
ticket_api_list is the same filtered, sorted, paged read the desk manager itself uses, scoped to
your API key's own desk and never including another tenant's tickets. Every field is optional; an
empty request lists everything, newest activity first.
Method
API: List Tickets
External service: lists tickets on the desk owned by the API key, with the same filters as the manager.
Walkthrough
List, filtered
Combine status, topic_id, reference_id and free-text search however your screen needs
them; sort is one of date_created_ts, last_activity_ts, status_ts or priority, dir is
asc or desc.
2. Turn the page
Pass the previous response's bookmark back as bookmark to continue past limit (up to 500 per
call, the field's own declared ceiling).
The response
data is an array of the same narrow ticket view open a support ticket
returns (no interactions here, this is the list, not the detail read), and bookmark sits
alongside it, at the top level, not inside data:
An empty data array is a real, successful answer for a desk with nothing matching the filter, not
an error.