List tickets
Returns tickets for an agent, sorted by updatedAt descending by default. Supports filtering and cursor-based pagination. Filters combine with AND across parameters.
Authorizations
API key from your account settings
Path Parameters
The agent ID
1"5QHA6VB-DIAbBhxwqxfdi"
Query Parameters
Opaque cursor from a previous response to fetch the next page
"eyJ0IjoiMjAyNC0wMS0xNVQxMDozMDowMC4wMDBaIiwiaWQiOiJhYmMxMjMifQ=="
Number of items per page (1 to 100, default 20)
1 <= x <= 10020
Comma-separated status categories (is-any-of). Categories: new, on_you, on_customer, on_hold, closed, cancelled.
"new,on_you"
Comma-separated channels (is-any-of).
"email,api"
Filter by assigned agent user id. Pass none for unassigned tickets.
none Filter by team id. Pass none for tickets with no team.
none Only tickets created at or after this ISO 8601 timestamp.
"2026-07-01T00:00:00Z"
Only tickets created at or before this ISO 8601 timestamp.
"2026-07-31T23:59:59Z"
Sort field. updatedAt and lastMessageAt fall back to createdAt when unset. Sorting by a mutable field means a page window is not a snapshot. Pollers should use sortBy=updatedAt&order=asc with a high-water mark.
createdAt, updatedAt, lastMessageAt "updatedAt"
Sort direction. Defaults to desc, newest first. A cursor is only valid for the sortBy/order it was issued with; changing either mid-walk is a 400.
asc, desc "desc"
When true, the response includes pagination.total (costs an extra count query).
true, false "false"
