Get Next Pair
Get the next pair of samples to compare.
- Auth: Supabase JWT only. API keys cannot reserve voting pairs.
- For anchored experiments: if anchor_value is omitted, the controller selects the best available pair across all anchors (never a random anchor pick).
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Headers
Path Parameters
Query Parameters
(Optional) restrict to a specific anchor value
Use policy-based pair selection before random fallback
0 <= x <= 1Response
Successful Response
Response with the next pair to compare.
Current sticky pair ID (required for vote binding)
First sample to compare
Second sample to compare
Whether audio voters may adjust playback speed
Structured anchor context for display
The anchor value both samples share (if anchored experiment)
Voting axes [{axis_key,label,description}] for a multi-axis experiment; None/empty => single default A/B.
Eligibility policy version used to validate this pair
Whether both-output playback thresholds are enforced for audio votes
True if this pair is an exam pair (quality control)
True when the current participant is linked to an account and must log in.
Required playback percentage for each audio output
0 <= x <= 100Minimum viewing time (seconds) before voting is accepted
x >= 0Short non-sensitive anonymous participant label.
Current public voting participant mode.
anonymous, transferred, authenticated, linked_requires_login True when an anonymous voter must choose start-new or continue before a pair can be served.
Optional hydrated upcoming pairs for client-side media warming
Remaining comparisons in the experiment pool
x >= 0Whether vote feedback is required for this experiment
Optional pair-selection diagnostics
Pair selection policy identifier used for this pair
Selection utility score for this pair
True when this pair ID is already accepted by vote submission.
Credits required to vote this pair (0 for exam)
x >= 0
