v1
latestOpenAPI 3.0.32026-07-222111928.0 KBCases
List Cases
List cases in a queue. Supports status, date-range, and free-text filters via query params. For label filters, use POST /v2/teams/:team_id/queues/:queue_id/cases/search.
get/v2/queues/{queue_id}/cases
Path parameters
queue_idstring uuid required
The queue's unique identifier
Query parameters
limitinteger
Number of cases per page (1-100, default 20).
offsetinteger
Zero-based offset for pagination.
statusstring
Filter by one or more case statuses (comma-separated). Values: pending, claimed, completed, failed, needs_input, postponed.
searchstring
Full-text search across case title and data.
created_at_fromstring
Return only cases created on or after this ISO-8601 timestamp.
updated_at_fromstring
Return only cases updated on or after this ISO-8601 timestamp.
sort_by'created_at' | 'updated_at' | 'postponed_to'
Field to sort by. Default: created_at.
sort_order'asc' | 'desc'
Sort direction. Default: desc.
Response
Default Response