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 status buckets (comma-separated). Values: all, pending, processing, needs_input, postponed, needs_review, resolved, canceled. processing covers both a case actively being worked and one waiting on its evaluation.

issue_severity
string

Filter by highest failing rubric severity (comma-separated). Values: critical, medium. Severity is a facet within the issues outcome, so it returns nothing when combined with a status bucket that excludes issues. low is not selectable: an all-low verdict is stored as success, so no case carries it.

priority
string

Filter by one or more priority levels (comma-separated). Values: none, medium, high.

Full-text search across case title and data.

created_at_from
string

Return only cases created at or after an ISO-8601 timestamp or a lookback such as 24h or 7d.

created_at_to
string<date-time>

Return only cases created before this ISO-8601 timestamp. The upper bound is exclusive.

updated_at_from
string

Return only cases updated at or after an ISO-8601 timestamp or a lookback such as 24h or 7d.

updated_at_to
string<date-time>

Return only cases updated before this ISO-8601 timestamp. The upper bound is exclusive.

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
count_only
enum<string>
default:false

Skip row selection and enrichment. The normal list response shape is returned with an empty row array and the matching total.

Available options:
true,
false

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