Skip to main content
GET
Get Anonymous Next Pair

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

X-Voter-Token
string | null
authorization
string | null
X-API-Key
string | null

Path Parameters

token
string
required

Query Parameters

voter_token
string | null

Deprecated: use X-Voter-Token header

anchor_value
string | null
prefetch_count
integer
default:0
Required range: 0 <= x <= 5

Response

Successful Response

Response with the next pair to compare.

pair_id
string<uuid>
required

Current sticky pair ID (required for vote binding)

sample_a
Sample A · object
required

First sample to compare

sample_b
Sample B · object
required

Second sample to compare

allow_playback_speed
boolean
default:false

Whether audio voters may adjust playback speed

anchor
Anchor · object | null

Structured anchor context for display

anchor_value
string | null

The anchor value both samples share (if anchored experiment)

axes
Axes · object[] | null

Voting axes [{axis_key,label,description}] for a multi-axis experiment; None/empty => single default A/B.

eligibility_policy_version
string | null

Eligibility policy version used to validate this pair

enforce_playback
boolean
default:false

Whether both-output playback thresholds are enforced for audio votes

is_exam
boolean
default:false

True if this pair is an exam pair (quality control)

login_required
boolean
default:false

True when the current participant is linked to an account and must log in.

min_playback_percent
integer
default:0

Required playback percentage for each audio output

Required range: 0 <= x <= 100
min_viewing_seconds
integer
default:0

Minimum viewing time (seconds) before voting is accepted

Required range: x >= 0
participant_label
string | null

Short non-sensitive anonymous participant label.

participant_mode
enum<string> | null

Current public voting participant mode.

Available options:
anonymous,
transferred,
authenticated,
linked_requires_login
participant_required
boolean
default:false

True when an anonymous voter must choose start-new or continue before a pair can be served.

prefetch
Prefetch · object[] | null

Optional hydrated upcoming pairs for client-side media warming

remaining_comparisons
integer
default:0

Remaining comparisons in the experiment pool

Required range: x >= 0
require_feedback
boolean
default:true

Whether vote feedback is required for this experiment

selection_components
Selection Components · object | null

Optional pair-selection diagnostics

selection_policy
string | null

Pair selection policy identifier used for this pair

selection_score
number | null

Selection utility score for this pair

submit_ready
boolean
default:true

True when this pair ID is already accepted by vote submission.

vote_cost_credits
integer
default:1

Credits required to vote this pair (0 for exam)

Required range: x >= 0