WHwhop
Experiments

List Experiments

Changed on

Lists the experiments and feature flags owned by an account. Requires experiment:read on the account.

get/experiments

Request

  • Base URL
    https://api.whop.com/api/v1
  • URL
    https://api.whop.com/api/v1/experiments
  • Auth
    HTTP bearer

Query parameters

account_idstring

Owning account ID.

idstring required

Referenced resource tag, belonging to the experiment owner.

object'app' | 'app_build' | 'product' | 'plan' required

Filter by related resource; requires account_id.

{
  "object": "app"
}
status'draft' | 'active' | 'paused' | 'ended'

Only experiments with this status.

firstinteger

Number of results to return from the start of the range.

afterstring

Return results after this cursor. Use page_info.end_cursor from the previous response to fetch the next page.

lastinteger

Number of results to return from the end of the range.

beforestring

Return results before this cursor. Use page_info.start_cursor from the previous response to fetch the previous page.

order'created_at' | 'flag_key'

The field to sort experiments by.

direction'asc' | 'desc'

Sort direction.

Response

experiments listed

Example response

{
  "data": [
    {
      "account_id": "biz_xxxxxxxxxxxxxx",
      "assignment_seed": "checkout_redesign_v21768435200",
      "bucket_by": "user",
      "configuration_revision": 1,
      "control": {
        "related_resource": {
          "object": "app"
        }
      },
      "created_at": "2026-01-01T12:00:00.000Z",
      "created_by": "user_xxxxxxxxxxxxxx",
      "ended_at": "2026-01-01T12:00:00.000Z",
      "findings": "Treatment lifted conversion 8%",
      "flag_key": "checkout_redesign_v2",
      "hypothesis": "Users will convert more",
      "id": "expt_xxxxxxxxxxxxxx",
      "name": "Checkout Redesign V2",
      "related_resource": {
        "object": "app"
      },
      "started_at": "2026-01-01T12:00:00.000Z",
      "status": "draft",
      "targeting_rules": [
        {
          "conditions": [
            {
              "operator": "any",
              "type": "user_id"
            }
          ],
          "type": "include"
        }
      ],
      "updated_at": "2026-01-01T12:00:00.000Z",
      "variants": [
        {
          "name": "treatment",
          "ranges": [
            [
              0,
              50
            ]
          ],
          "related_resource": {
            "object": "app"
          },
          "weight": 50
        }
      ],
      "winning_arm": "treatment"
    }
  ],
  "page_info": {
    "start_cursor": "WyJjdXJzb3IiLDFd"
  }
}

Changes

  • 7d2eaa643369Revision changes
    • breaking

      for the query request parameter account_id, default value internal was removed

  • ff3a76573563Revision changes
    • breaking

      for the query request parameter first, default value 20 was added

    • warning

      for the query request parameter first, the max was set to 100.00

    • warning

      for the query request parameter last, the max was set to 100.00