Skip to main content
GET
List a decision's labeled cases

Authorizations

Authorization
string
header
required

An API key, sent as Authorization: Bearer <key>. Each operation lists the scope its key needs: decisions:evaluate (evaluate and read evaluations), decisions:feedback (your app's feedback) or decisions:develop (everything else, including owner feedback and the review queue). An operation listing no scope takes any scoped key. A key with no scope, or without the operation's, gets 403 INSUFFICIENT_SCOPE.

Path Parameters

decision_id
string
required
Pattern: ^[a-z][a-z0-9_.-]{0,127}$

Query Parameters

limit
integer
default:50
Required range: 1 <= x <= 200
cursor
string
Required string length: 1 - 1024
outcomes
string

Outcome names, comma-separated (no spaces) or as a JSON array (["refund, partial","deny"]). Only cases labeled one of them are listed.

Required string length: 1 - 4096
structure_hash
string
Pattern: ^sha256:[0-9a-f]{64}$
label_source
enum<string>

Where the label came from: human, synthetic (an agent made it) or unknown. Only human counts toward the no-new-severe-mistake rule.

Available options:
human,
synthetic,
unknown
since
string<date-time>
until
string<date-time>
include
enum<string>
Available options:
content

Response

A page of cases

environment
enum<string>
required

The environment of the key that made the call: production or test. Evaluations, feedback, reviews and suggestions are separate per environment; registered structures are shared.

Available options:
production,
test
decision_id
string
required
Pattern: ^[a-z][a-z0-9_.-]{0,127}$
cases
object[]
required
total
integer
required

Cases that match the filters, across every page.

Required range: x >= 0
excluded
object
required

Evaluations with feedback that are not cases, by reason: withdrawn (all feedback withdrawn), retired (feedback older than the last policy change), excluded (flagged input_broken), contested (reviewers disagree), no_consensus (no feedback that decides an outcome), no_outcome (feedback rules outcomes out without naming one), outcome_not_in_result (expected outcome not in outcomes), no_deciding_ballot, attribute_inputs_unavailable (stored before attribute inputs were kept, with a default that can't be read back), no_split (not yet in a split group), duplicate_group (another evaluation of the same item group counts instead).

next_cursor
string | null
required
has_more
boolean
required