Evaluate Experiments
Evaluates and records an exposure without requiring authentication. When credentials resolve, their authentication method, API key ID, and signed-in user ID are recorded on the exposure event. Pass subject for bucketing identity and account_id for experiment ownership.
Pass flag_key to check a single flag, or omit it to fetch active flags in the account and related resource scope. Internal anonymous callers may use the x-whop-anonymous-id header or ajs_anonymous_id cookie; explicit subject[anonymous_id] takes precedence.
Assignments use exactly the configured bucket_by: subject[user_id], subject[account_id], or subject[anonymous_id]. Internal user experiments derive identity from the signed-in session. Missing the required identity fails single evaluation and omits the experiment from batch evaluation. Subjects outside all treatment ranges receive control.
Pass subject[account_id] to enable account-level targeting rules. Pass properties as a JSON object to supply the values that property targeting conditions match against.
Authorizations
An Account API key, account-scoped JWT, App API key, or user OAuth token. Prepend the key or token with Bearer, for example Bearer ***************************.
Headers
Pins the request to a dated API version.
"2026-09-11"
Query Parameters
Bucketing subject. Ownership is the top-level account_id. Account experiments accept caller-supplied subject IDs; internal experiments derive the user from the session.
Restricts batch evaluation to this related resource; omitted batches contain only unbound experiments.
Flag or experiment to evaluate — the flag_key handle or the expt_ id. Omit to return all flags the caller qualifies for.
Owning account ID or internal. Required when evaluating by flag_key or in a batch; optional for an expt_ ID.
Response
single flag evaluated
- Option 1
- Option 2
Whether the subject receives a treatment or enabled feature flag.
true
Treatment name, control, or null for an inactive flag or excluded subject.
"treatment"
Unique experiment ID, included for account experiments.
Present when evaluating a single experiment.
"checkout_redesign"

