Skip to main content
GET
List Cases

Authorizations

Authorization
string
header
required

API key authentication. Get your API key from the Duvo dashboard.

Path Parameters

queue_id
string<uuid>
required

The queue's unique identifier

Query Parameters

limit
integer
default:20

Number of cases per page (1-100, default 20).

Required range: 1 <= x <= 100
offset
integer

Zero-based offset for pagination.

Required range: 0 <= x <= 9007199254740991
status
string

Filter by one or more case statuses (comma-separated). Values: pending, claimed, completed, failed, needs_input, postponed.

Full-text search across case title and data.

created_at_from
string

Return only cases created on or after this ISO-8601 timestamp.

updated_at_from
string

Return only cases updated on or after this ISO-8601 timestamp.

sort_by
enum<string>
default:created_at

Field to sort by. Default: created_at.

Available options:
created_at,
updated_at,
postponed_to
sort_order
enum<string>
default:desc

Sort direction. Default: desc.

Available options:
asc,
desc

Response

Default Response

cases
object[]
required
total
number
required
limit
integer
required
Required range: -9007199254740991 <= x <= 9007199254740991
offset
integer
required
Required range: -9007199254740991 <= x <= 9007199254740991