Skip to main content
GET
List cases

Authorizations

Authorization
string
header
required

Send Authorization: Bearer YOUR_API_KEY. The key resolves to a single organization.

Path Parameters

id
string<uuid>
required

Benchmark id.

Query Parameters

includeRetired

Also list retired cases.

tag
string[]

Keep cases carrying any of these tags.

Maximum string length: 40
type
enum<string>
Available options:
turn,
conversation,
audio
checkGroupId
string<uuid>

Only cases in this group.

limit
integer
default:50

Items per page. Default 50, max 200 (larger values are clamped to 200). Must be a positive integer; anything else is rejected with a 400 invalid_parameter.

Required range: 1 <= x <= 200
cursor
string

Opaque pagination cursor. Pass the nextCursor returned by the previous page, unchanged. A cursor this API did not issue is rejected with a 400 invalid_parameter. List endpoints also answer 400 unknown_query_parameter (listing the valid names) for any query parameter they do not accept, so a misspelled filter such as agent_id is never silently ignored.

Response

Successful response.

data
object[]
required
nextCursor
string | null
required

Cursor for the next page, or null on the last page.