---
title: "Evaluate Experiments"
method: GET
path: "/experiments/exposures"
tags: ["Experiments"]
---

# Evaluate Experiments

`GET /experiments/exposures`

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.

Pass `log_exposure=false` to read an assignment without recording an exposure, for a client that caches assignments up front and records the exposure when the arm is actually rendered. Omitted records the exposure, so pinned callers are unchanged.

## Query parameters

- `subject` object
  - `account_id` string
  - `anonymous_id` string
  - `user_id` string
- `related_resource` ExperimentResourceReference
  - `id` string, required — Referenced resource tag, belonging to the experiment owner.
  - `object` 'app' | 'app_build' | 'product' | 'plan', required
- `flag_key` string
- `account_id` string
- `log_exposure` boolean

## Response `200`

single flag evaluated

- union
  - ExperimentExposure
    - `configuration_revision` integer
    - `enabled` boolean, required — Whether the subject receives a treatment or enabled feature flag.
    - `experiment_id` string — Unique experiment ID, included for account experiments.
    - `flag_key` string — Present when evaluating a single experiment.
    - `related_resource` ExperimentResourceReference
      - `id` string, required — Referenced resource tag, belonging to the experiment owner.
      - `object` 'app' | 'app_build' | 'product' | 'plan', required
    - `variant` string, nullable, required — Treatment name, control, or null for an inactive flag or excluded subject.
  - ExperimentExposureBatch
    - `exposures` object, required

## Changes

> 71 revisions in range; 1 not diffed.

- **2026-09-15** `c19acf2e2548` — 1 info
  - added the new optional `query` request parameter `log_exposure`

[Change history](https://skmtc.dev/whop/apis/whop-api/changes/experiments/exposures/get.md)

---

[API](https://skmtc.dev/whop/apis/whop-api.md) · [All operations](https://skmtc.dev/whop/apis/whop-api/llms.txt) · [OpenAPI document](https://skmtc.dev/whop/apis/whop-api/revisions/c1dceb26e505?raw)